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Preface 


This manual explains how to use the IBM 3270 
Personal Computer Control Program. The IBM 
3270 Personal Computer Summary card and the 
IBM 3270 Personal Computer Control Program 
diskettes are provided at the back of this man- 
ual. The summary card can be used as a quick 
aid to help you remember different procedures as 
you perform tasks on the work station. 


Who Should Use This Manual 


This manual is intended for end users and for 
installation and systems personnel. It explains 
the keys, functions, and procedures that are used 
to perform a task on the IBM 3270 Personal 
Computer. The manual will be of the greatest 
value to the person sitting at the work station 
who needs specific procedures on how to perform 
a particular function. 


How This Manual Is Organized 
This manual has 13 chapters, eight appendixes, a 
glossary, and an index: 


Chapter 1, Introducing the IBM 3270 Personal 
Computer, acquaints you with this product. 


Chapter 2, Understanding the System, defines 
terms and important concepts. 
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Chapter 3,. Loading the Control Program, 
describes how to begin a work station session. 


Chapter 4, Using the Keyboard, explains the 
keyboard. 


Chapter 5, Working in Application Mode, 
describes the application mode. 


Chapter 6, Working in Work Station Control 
Mode, describes the work station control mode. 


Chanter 7, Using Set 


ro Un 
i vee ’ eee naswee Pr) RAW 2A AAD 240 se 
change your windows and screen profiles. 


Chapter 8, Browsing, shows you how to browse 
the contents of a window. 


Chapter 9, Copying, explains how to copy infor- 
mation from one window to another. 


Chapter 10, Autokeying, shows the procedures 
you perform for the autokey function. 


Chapter 11, Using Save and Restore, describes 
the save and restore functions. These commands 
save and restore autokey recordings, notepads, 
and screen arrangements. 


Chapter 12, Printing, explains how to print infor- 
mation from the IBM 3270 Personal Computer. 


Chapter 13, Transferring Files, describes how to 
transfer files back and forth between a host and 
the work station. 


Appendix A, Customizing the System Diskette, 
describes the procedures for customizing the 
IBM 3270 Personal Computer. 


Appendix B, Solving IBM 3270 Personal Com- 
puter Problems, helps you solve problems you 
may encounter. 


Appendix C, Installing and Removing Patches, 
contains the procedures you need to install or 
remove permanent changes to the code and data 
on the customized system diskette. 


Appendix D, Using the Trace Facility, describes 
the facility used to gather data required to 
isolate software problems in the control 
program. 


Appendix E, Using Messages, lists messages, ex- 
planations, and user responses. 


Appendix F, Using Command Procedures for 
Save and Restore and File Transfer, shows you 
how such procedures can be used to simplify 
save and restore and file transfer operations. 


Appendix G, Technical Notes, contains infor- 
mation on 3270 functions, 3270 Data Stream, 
mandatory usage of slots inside the system unit, 
and personal computer notes. 


Appendix H, Using Program Symbols, discusses 
the feature that allows an organization to define 
up to six character sets or fonts. 


The Glossary defines terms that may be unique 
for this product. 


The Index contains entries and cross-referenced 
terms to help you find information. 


Notes: 


1. The term control program refers to the IBM 
3270 Personal Computer Control Program. 


2. The term customized system diskette refers 
to the IBM 3270 Personal Computer 
Control Program diskette that has been 
customized. 
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The term window is the equivalent of the 
term viewport as used in the IBM 3270 
Information Display System: Data Stream 
Programmer’s Reference manual, 
GA23-0059. 


The term DOS refers to the IBM Personal 
Computer Disk Operating System Version 
2.0 and subsequent versions of DOS. 


Any names mentioned in either the photo- 
graphs or the text of this manual are purely 
Le ntetsnssg and An nant volar tran nawranna lxinge 
LICLILIOUS aa GO ove reer vO persons saving 


or dead. 


Related Publications 


Following are the available IBM 3270 Personal 
Computer manuals: 


® Introduction and Preinstallation Planning, 
GA23-0179 


Provides information for evaluating and 

planning the installation of the IBM 3270 
Personal Computer and planning the cus- 
tomization of the IBM 3274 Control Unit. 


® Guide to Operations, SA23-0141 (1837432) 


Provides procedures for hardware setup, 
operation, and customer problem analysis 
and recovery (CPAR). This manual is not 
dependent on the Control Program or on an 
application program. (Does not include disk- 
ettes or connectors.) 


@® Maintenance Information, SY27-2567 
(1837436) 


Provides hardware problem-recovery pro- 
cedures, a parts catalog, and maintenance 
information. 


@ Online Tutorial, SA23-0163 (1837433) 


Provides an introduction to the Control Pro- 
gram facilities, as well as guidance for using 
the Control Program. (Includes diskettes.) 


® Control Program: Programming Guide, 
SC23-0165 


Provides information for writing IBM 3270 
Personal Computer applications that run in 
the 3270 Personal Computer, control the 
personal computer session, and interact 
with a host program. 
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Statement of Service 


Vili 


Program service for the IBM 3270 Personal 
Computer Control Program is central 
service, including an IBM Support Center. 
Program services will be provided only for 
the latest refresh and will be available for 
the prior release for ninety (90) days follow- 
ing the release of a new refresh from IBM. 
Program services will be discontinued on 
June 1, 1985. 


IBM central service will respond to a defect 
in the unaltered portion of a supported 
release of the licensed program by issuing: 
defect correction information such as correc- 
tion documentation, corrected code, or 
notice of availability of corrected code; a 
restriction; or a bypass. 


IBM does not guarantee service results, or 
that the program will be error-free, or that 
all program defects will be corrected. 


Program service from IBM will be provided 
only to quantity discount agreement (QDA) 
contracted customers via the designated 
customer technical support location. Cus- 
tomers with less than 20 licenses must sign 
a QDA to obtain central service support. 


The customer technical support location 
should be designated when the IBM 3270 
Personal Computer is ordered. 


The customer technical support location will 
register, through the IBM marketing repre- 

sentative, up to three technical coordinators 
who will be eligible to obtain central service 

support. 


The customer technical support location will 
act as the interface for the customer with 
the IBM Support Center. 


The IBM Support Center, in call-back mode, 
will provide the customer who is designated 
the technical coordinator with telephone 
assistance in problem diagnosis and resolu- 
tion. This customer-designated technical 
coordinator may call the IBM Support 
Center at any time and will receive a call 
back within eight (8) business hours. The 
IBM Support Center will contact the cus- 
tomer’s technical support location, Monday 
- Friday, 8:00 A.M. - 5:00 P.M., local cus- 
tomer time. 


The IBM Support Center is the established 
point of contact between the customer tech- 
nical coordinator and IBM central service. 


The technical coordinator will be the first 
level of end user assistance. You are advised 
to contact your technical support location 

if you have any problems requiring IBM 
assistance. 

The customer technical support locations’ 
responsibilities include, but are not limited 
to: 

— Problem determination 

— Problem source identification 


— Submitting APAR data 


— Applying preventive and corrective 
service 


— Performing activities recommended by 
IBM support organization(s). 
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@ Preventive service is provided on a cumula- 
tive basis through refreshes. Refreshes are 
distributed to the designated customer tech- 
nical support location on diskettes. 


@® One copy of each refresh and its supporting 
documentation will be provided to the cus- 
tomer’s technical support location. The 
customer’s technical support location is re- 
sponsible for making and distributing copies 
to the work stations with the IBM 3270 Per- 
sonal Computer Control Program installed, 
not to exceed the total copies licensed to the 
customer. 


® Additional copies of the refreshes and sup- 
porting documentation may be ordered by 
the technical support location for shipment 
to the technical support location for an addi- 
tional charge, not to exceed the total copies 
licensed to the customer. 


® Corrective service, if any, will be provided 
only for the latest refresh level to the cus- 
tomer technical support location. 


Operating Environment 


The IBM 3270 Personal Computer Control Pro- 
gram is designed to operate on the IBM 3270 
Personal Computer machine configuration 5271 
standard models 2, 4, 6, 24, and 26 when 
installed with IBM Personal Computer Disk 
Operating System (DOS) 2.1. 
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Notes: 


A Work Station to Meet Your 
Needs 


Imagine that you are sitting at your desk sur- 
rounded by IBM displays and keyboards. A vari- 
ety of 3270 and personal computer applications 
are at your fingertips — if only you can find a 
way to bring this hardware and software 
together into one work station. 


You can. With the IBM 3270 Personal Com- 
puter, you can conduct personal computer and 
3270 sessions at the same time, using one key- 
board and one screen. And the 3270 Personal 
Computer offers its own unique capabilities. For 
example, on the same screen where 3270 and per- 
sonal computer sessions are displayed, you can 
use an online notepad, which is like a one page 
scratch pad, for jotting down information that 
you can save or discard. You will also be able to 
perform a rich variety of functions, such as sav- 
ing keystrokes, adding color, enlarging the con- 
tents on your screen, and copying information 
from a personal computer session to a 3270 ses- 
sion. All these capabilities, and more, combine in 
a work station that will be customized to meet 
your particular needs. 
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A Look at Your Hardware 


First, let’s take a look at your system. The IBM 
3270 Personal Computer consists of a display 
monitor, a system unit, and a keyboard. The dis- 
play monitor can be either color or monochrome. 
The system unit allows you to store personal 
computer files on diskettes and/or a fixed disk. 


The IBM 3270 Personal Computer and its key- 
board were designed to handle a large range of 
functions so that, as you gain experience, your 
work station will meet your growing needs. The 
keyboard is your tool for controlling the work 
station, for signaling application programs, and 
for entering information. This keyboard looks 
different from other keyboards that you have 
used. Chapter 4 will explain the differences 
between this keyboard and the IBM Personal 
Computer and 3270 keyboards. 


If you are not yet familiar with operating your 
IBM 3270 Personal Computer, please read Chap- 
ter 2 of your IBM 8270 Personal Computer 
Guide to Operations at this time. This chapter 
discusses the controls and operation of your 
hardware. 
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5272 Color Display 


5271 Monochrome Display 


Fitting Your Needs 


It is important to understand that, when you 
look at your IBM 3270 Personal Computer, it is 
almost like viewing the surface of a lake. You 
know that beneath that surface another world 
exists that you cannot see. When you look at 
your work station, you will see only one display, 
one keyboard, and one system unit. Yet beneath 
this surface are the capabilities to interact simul- 
taneously with, and display on one screen four 
3270 sessions, one IBM Personal Computer ses- 
sion, and two online notepads. The following 
figure illustrates this concept: 


3270 3270 3270 3270 


f JL IC) CO 


Notepad Notepad 


ed eel 


Personal 
Computer 
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You choose how you want to use the functions of 
the IBM 3270 Personal Computer. If you want it 
to function solely as a personal computer, load 
the IBM Personal Computer Disk Operation 
System. You can then use IBM Personal Com- 
puter software for numerous applications. The 
HELPER tutorial, a self-help diskette that 
comes with this work station, is one example of 
software that can be used when your work sta- 
tion functions like a personal computer. 


You can also use your IBM 3270 Personal Com- 
puter so that it operates either as an existing 
IBM 3278 Display Station Model 2, 3, 4, or 5 
terminal or a 3279 Display Station Model 2 or 3, 
as well as an IBM Personal Computer. You can 
replace an existing 3278 Model 2 with your IBM 
3270 Personal Computer without any other 
preparation. 


You can also customize a more advanced config- 
uration that allows your IBM 3270 Personal 
Computer to support up to four 3270 host ses- 
sions concurrently over a single coaxial cable 
connection to the IBM 3274 Control Unit. A per- 
sonal computer session and two notepad sessions 
will also be supported concurrently by the IBM 
3270 Personal Computer. 


A graphics capability is another key function on 
the IBM 3270 Personal Computer. With the in- 
stallation of an All Points Addressable (APA) 
adapter, you can use graphics applications in a 
personal computer session. In addition, host 
computer session graphics is provided with the 
Programmed Symbols (PS) adapter. This allows 
you to display graphics in a host computer 
session. The following illustration shows the 
graphics capability. 


Getting Help 


In addition to the HELPER tutorial and this 
User’s Guide, online aids have been provided to 
help you master the IBM 3270 Personal 
Computer: 


® You will receive operating and status infor- 
mation in the operator information area 
(OIA) at the bottom of your display screen. 


@ You can get help by pressing the Help key. 
The Help panel that appears on your screen 
will list the active functions that relate to 
what you are doing. There are several differ- 
ent Help panels. 


@ As you type in commands and information, 
the system will respond by displaying 
prompts and messages to guide you and to 
let you know when there are problems. 
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For quick reference, you will find at the back of 
this book a summary card containing important 
functions. 


Using This Book 
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This book will help you learn how to use the 
IBM 3270 Personal Computer and also serve as 
a reference guide as your abilities increase with 
practice. Use this book in conjunction with 
HELPER, our online tutorial that will guide you 
through a series of graphics, information sum- 
maries, and interactive exercises. After you have 
read Chapter 2, read the HELPER tutorial book- 
let and then work through the tutorial. 


Chapter 2 will give you an overview of important 
concepts and terms. At the beginning of Chap- 
ters 3 through 13, we will remind you of key 
terms. Since some of the concepts of the IBM 
3270 Personal Computer may be unfamiliar to 
you, it will be helpful to you if you learn these 
terms. 


Chapter 2. Understanding the 
System 


Contents 

TtPOOUCHIONi..5.55 aed 64 tada ea ce eg eat eee es 2-3 
Presentation Space............ 2.000 eee eee 2-4 
WINGCOWS wo fare a-65 etude era e hunting are eee 2-5 
BCreen Promless) in cincan th ede ee anad ee REA a ae 2-10 
Pinlargine Windows: sano h6s oe Sep ESSE SLOSS BS 2-14 
AUtO-WINGOWIN® » <u b8 Ms che he Paha eds ohda Paes 2-16 
Application Mode = 224 sidécnac aoe ye oak e ees bene es 2-18 
Work Station Control Mode..................... 2-20 
Understanding the Operator Information Area..... 2-22 


Application Mode Operator Information Area.. 2-22 
Work Station Control Mode Operator 


Information Area..............2-- 0c eee eee 2-25 
Gettin’ Hele si os bated hace wie 4 oe tieg eee es: 2-26 
Understanding Your Display Screen.......... 2-26 
Using Help Panels 5 2: 04.663 «ae we%ldaw hs anes 2-28 
Listing Screen Profiles, Windows, and Autokey 
ReCOrdings 207 iweactuesee tad See cewek ents s 2-31 
Online Tutorial: 244.2 caaas o6 oeete ees ee das 2-32 
Other Functions 4.250023. 2 5 cease. othe tat wake eae eee 2-33 
Browsing the Contents of Your Presentation 
SPACE Jdaccs 506 Ss Aon Sb eG ha aie etek. GAS in 2-33 
Copying Information.................0.005- 2-33 
Recording and Playing Keystrokes........... 2-34 
Saving and Restoring Information ........... 2-34 
Printing Screen Profiles and Sessions......... 2-35 
Transferring Piles: 3.3 4 dvslens sas oe ware ess 2-35 


Understanding the System 2-1 


Notes: 


2-2 


Introduction 


This chapter is essential for anyone who wants 
to use the IBM 3270 Personal Computer to its 
fullest capacity. We will introduce new concepts 
and vocabulary, which will be elaborated upon in 
the rest of the book. Specifically, we will discuss: 


Presentation space 

Windows 

Screen profiles 

Enlarging a window 
Auto-windowing 

Application mode 

Work station control mode 
Understanding the operator information 
area 

Getting Help 

Understanding your display screen 
List 

Online tutorial 

Autokey 

Copy 

Save/restore 

Print 

File transfer. 
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Presentation space is a concept. It does not exist 
physically, like your display screen. 


Presentation space represents the area that con- 
tains the data that goes to your display screen 
during a 3270 host session, an IBM Personal 
Computer session, or a notepad session. As we 
mentioned previously, with the IBM 3270 Per- 
sonal Computer you can simultaneously display 
seven sessions on one screen. This means that, if 
you have seven sessions on your screen, you will 
also have seven presentation spaces. If you are 
working in a 3270 session, you will have a 3270 
presentation space. If you are working in a per- 
sonal computer session, you will have an IBM 
Personal Computer presentation space. 


The presentation space for 3270 terminals (3278 
Display Stations 3, 4, and 5) may be larger than 
the IBM 3270 Personal Computer displays, 
Models 5251 and 5272. Thus, what you see on 
your screen may not be all that there is in your 
presentation space. 


Windows 


How, then, can you see what is in your presenta- 
tion space? A window lets you see the data 
within your presentation space. A window can be 
the same size as your full IBM 3270 Personal 
Computer display screen; or the window can be 
as small as one character. 


With the IBM 3270 Personal Computer you can 
have multiple arrangements of windows on your 
display screen. Your display screen can have one 
window per session for: 


@ Up to four host sessions. A 3270 session is 
called a host session throughout this book. 
Information developed in host sessions is 
stored in the host computer. 


@ One IBM Personal Computer session. The 
work you do in this session can be stored on 
a personal computer diskette or a fixed disk. 


@ Up to two notepad sessions. A notepad is a 
work area on the display screen. The work 
you do there can be stored on a personal 
computer diskette or a fixed disk. 


To see how windows work, let’s envision an in- 
surance executive who is using the work station 
to write a memo. To do this, our executive needs 
to keep track of schedules and various other in- 
formation. So the executive sets up the display 
screen with four windows, each containing a 
different session: 


A personal computer session called X-PC; 
A host session called A-Host1; 


Two notepads called N-Notes and 
R-Reminder. 
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The windows might appear as in the illustration 
below: 


NOL 


“REMINDER 
1. Meet w/ Jack re. headcount prior to 10/1 meeting. 
2. Check status of FALLS Project. 


Let’s look at: the naming conventions for these 
sessions. One of the notepad sessions is named 
R-Reminder. 


R-Reminder 


/ \ 


Short Name Full Name 


R is the short name of the window. The short 
name is a letter (A-Z) displayed within the upper 
left corner of the window border. This name is 
chosen during customization. 


Reminder is the full name of the window. It, too, 
appears with the short name and is chosen dur- 
ing customization. 


Referring to the windows, our insurance execu- 
tive writes a memo that incorporates budget 
projections and information. 


What if our executive were writing the memo in 
window X (personal computer session) and 
wanted to jot down an idea for another meeting 
in Window N, a notepad session? He/she would 
simply press the Jump key until the window 
wanted, window N, contained the cursor and dis- 
played the double border. Now window N is 
active, and our executive could type new infor- 
mation in it. 


The screens on the following pages show jump- 
ing from window to window. Note that as each 
window is jumped to, it displays a double border 
and the cursor appears in its upper lefthand 
corner. 
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Jumping between Windows 


~-NOTEPAD2 


ee ae a ee ne 


Press Jump 


Press Jump 


B--HOST2 


~-NOTEPAD2 
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Our insurance executive is a busy person. Now 
he/she needs to review a policy for a client. In 
order to do this, the executive needs to use a dif- 
ferent screen profile. 


Screen profiles are configurations of windows. 
Each session you choose is always represented 
by a window on Screen Profile 0. Screen Profiles 
1 through 9 may contain variations in the num- 
ber, size, and color of the windows from Screen 
Profile 0. During customization, you or your sys- 
tems personnel choose which combination of 
host, personal computer, and notepad sessions 
you will be using. Customization is explained in 
Appendix A. Our insurance executive’s arrange- 
ment of a host, personal computer, and two note- 
pad sessions was an example of one screen 
profile. You can create, use, and save up to ten 
screen profiles. Each can have from one to seven 
windows, sized just the way you want them. The 
following illustration shows how screen profiles 
work. 


3270 IBM Personal Computer Notepad 
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Let’s go back to our insurance executive’s need 
to review a client’s policy. In order to accomplish 
the second task, he/she creates another screen 
profile that has six windows. With this profile 
our executive displays four host sessions: A- 
Host1, B-Life, C-Home, and D-Auto. He/she is 
writing in a notepad session, R-Reminder, and 
will use the persona! computer session to com- 
pose a report for the client. 


R-REMINDER 

CALL DICK SMITH 
(772-3328) 
RE POLICY 


LUNCH 1:00-KEN 


(HOME 


ENTER POLICY &; 
Th 


;FIRST; RICHARD 


J 


$2Z TOBIN COURT 


ATLANTA 
GA ZIP: 30313 
COVERAGE 
BUILDING: 200000 PREM 
CUNTERTS 59000 550,00 
PERSUNAL: 100000 MODE:A 
RIDER 259000 


How did our executive change from the screen 
profile where he/she worked on the memo to the 
screen profile containing client information? He/ 
she simply pressed the ChgSc key. This key al- 
lows a user to move in numeric order through 
defined screen profiles. A defined screen profile 
is a screen profile that has at least one window. 
For further details, see Chapter 7. 
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Changing Screen Profiles 


Screen Profile 1 


B--HOST2 


Press ChgSc 


Screen Profile 2 
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Often you may want to enlarge the dimensions 
of your window to cover the full display screen. 
For example, when the insurance executive was 
writing the 20-line memo, he/she couldn’t see the 
entire contents in the window being used. To 
display the entire memo on the screen, our exec- 
utive would press the Enlarge Window key. 


If our executive typed a memo in a host com- 
puter window that was larger than the size of a 
full screen and wanted to review it, he/she would 
have to move the information forward and back- 
ward to display it in the enlarged window, just 
as you do in a 3270 or personal computer ses- 
sion. The active window would remain enlarged 
until the Enlarge Window key is pressed again. 


When you enlarge a window, the borders disap- 
pear and no other windows appear. A border is 
the boundary that marks the edges of the win- 

dow. The following illustration shows an exam- 
ple of an enlarged window. 
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Auto-windowing 
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You do not need to enlarge your window to type 
in data. As you type, the characters will always 
appear within the window. When the characters 
you are typing reach the right edge of the win- 
dow, the information on the left side of the win- 
dow moves out of sight, character by character. 
When you reach the bottom line of the window, 
the top line of type will disappear from your 
screen to make room for the new line you are 
entering. This means you can keep on typing 
without worrying about reaching the window 
borders until you reach the end of the presenta- 
tion space. Then the cursor wraps to the oppo- 
site side from where it was. 


Sometimes, due to the personal computer appli- 
cation program currently running in the personal 
computer window, this automatic function may 
not happen. See Appendix G for further 
information. 


The following illustration shows this automatic 
function. 


B--HOST2 


re - -NOTEPADZ 
H} Call Annie at 3:00 pm about the presen 


When the characters you are typing reach the 
right edge of the window, the information on the 
left side moves out of sight. 


B--HOSTZ 


about the presentation for the weet ingll 
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Application Mode 


If you want to work in a host, personal com- 
puter, or notepad session, you must be in appli- 
cation mode. One way you can tell which session 
you are in is by looking for the active window. 
An active window is double-bordered and con- 
tains the cursor. 


@ If your active window is a host window, 
your keyboard is a host keyboard and you 
can conduct a host session. 


@ If your active window is a personal com- 
puter window, your keyboard is a personal 
computer keyboard and you can conduct a 
personal computer session. 


@ If your active window is a notepad window, 
your keyboard is a notepad keyboard and 
you can conduct a notepad session. 


When you are in application mode, the most im- 
portant thing to remember is that your keyboard 
can operate in only one session at a time. 


Another way you can tell which session you are 
in is by looking at your operator information 
area (OIA). An operator information area in ap- 
plication mode will be the same color as the 
background color of your active window and 
gives you the short name of the active session. 
The operator information area is discussed later 
in this chapter. 


You will find more information about application 
mode in Chapter 5. 


A screen profile with an active window in host 
session follows. 


Screen Profile in Application Mode 


Double Borders 
around Active Window 


Cursor in Window 


Operator Information Area Matches 
the Color of the Active Window 


Window =B 
Screen = 1 
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Work Station Control Mode 


You probably noticed that not only were the ses- 
sions different on our insurance executive’s 
screen profiles, but the color, placement, shape, 
and size of his windows varied, too. 


With the IBM 3270 Personal Computer you can 
size, hide, corner, and move your windows - and 
change their color too. To perform these SetUp 
functions you need to be in work station control 
mode. From work station control mode, you can 
enter SetUp to make changes in your screen 
profiles. 


When you are in work station control mode, you 
can also add and delete windows, browse 
through the contents of a window, copy informa- 
tion within and between windows, and record 
and play back keystrokes. To get into work sta- 
tion control mode, press the WS Ctrl key. To re- 
turn to application mode, press the WS Ctrl key 
again. 


When you are in work station control mode, your 
cursor will be displayed in the operator informa- 
tion area. The operator information area will be 
highlighted, and the letters WSCTRL will 
appear at the left. Remember that in application 
mode the cursor will always be displayed in the 
active window. 


In order to perform work station control mode 
functions, you must select the window you want 
to change. When it is selected, your window will 
be double-bordered. To select a window, either 
press the Jump key until the window you want 
to change displays the double border or type the 
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short name of the window. Remember, the short 
name is a letter (A-Z) displayed within the upper 
left corner of the window border. 


You will find more information about work sta- 
tion control mode in Chapter 6. 


A screen profile with a selected window follows. 


Screen Profile in Work Station Control Mode 


Double Borders around Window 


B- -HOST? 


WINDOW=X SCREEN=2 


Reverse Video Cursor in 
operator information area operator information area 
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Understanding the Operator 
Information Area 


Application Mode Operator 
Information Area 


Application mode contains three types of 
sessions: 


@ Host 
@ Personal Computer 
@® Notepad. 


Each type of session in application mode has its 
own operator information area and is the color of 
the active window. The operator information 
area automatically covers the last line of your 
display screen for the host and notepad sessions. 
If you have a host session active with a red 
background in the window, your host session 
operator information area will be red. 


You will not see the operator information area 
for the active personal computer session unless 
you press Ctrl + WS Ctrl keys. Then the opera- 
tor information area overlays the last line of 
your display screen. If the operator information 
area overlaps the last line of your window and 
your cursor happens to be at the last line of your 
window, the cursor no longer appears. It is over- 
laid with the operator information area. You can 
toggle the personal computer session operator in- 
formation area off by pressing Ctrl + WS Ctrl 
keys again. Your cursor will again appear. You 
could also size and move the personal computer 
window so that the last line is not overlaid with 
the operator information area. 
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If your system is customized for CUT, your 
operator information area contains host informa- 
tion. In addition, you can see information sent 
by the control program by pressing Ctrl + WS 
Ctrl. 


In work station control mode, the operator in- 
formation area is white with black letters and 
contains the cursor. 

The operator information area contains different 
information in application and work station con- 
trol modes. In application mode, the operator 
information area tells you such details as: 


@ Whether you are in a host, notepad, or per- 
sonal computer session 


@ When the system will not accept keystrokes 


@ Whether entered information will be 
inserted 


@ Whether you have pressed the Shift key 


@ When you are using autokey record and play 
functions 


What the 3274-attached printer status is 
What your current screen is 


What your active window is 


What the host computer status is 
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For further information on status and operator 
indicators in the operator information area, see 
the IBM 8270 Information Display System 3278 
Display Station Operator’s Guide. 


In application mode, your operator information 
area may look like this: 


A3 4 
SHORT SCREEN R (RECORD) P (PAUSE) UPPERCASE 
NAME PROFILE = P (PLAY) UM 
FOR (0-9) 

WINDOW 
ID (A—Z) 


Work Station Control Mode Operator 
Information Area 


In work station control mode the operator infor- 
mation area may tell you: 


@ Whether you are in Browse, Autokey, Copy, 
Print, or SetUp 


@® What functions in SetUp, Copy, or Autokey 
are active 


@ What your selected window is 
What your current screen is 
Whether the window is enlarged. Please 
note that the enlarge symbol appears only in 
the work station control mode operator in- 
formation area. 

@ What your autokey status is 

@ Whether you have pressed the Shift key 

@ Whether a WS Ctrl message is displayed. 


In workstation control mode, your operator in- 
formation area may look like this: 


WSCTRL WINDOW = G SCREEN = 3 


BRWSE COLOR FRGND Autoname CHO) REC PAUSE Gs Msg = 
AUTO MOVE BKGND Input Area PLAY OVRRN 


COPY SIZE SCRBK 
PRINT REC NAME 
SETUP PLAY 

ERASE 

TARGT 

SOURC 

SCR 
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Getting Help 


In addition, the IBM 3270 Personal Computer is 
equipped with special information, overlaid on 


your display screen, to make work easier for you. 
There are: 


@ Help panels 
@ List panels 
@® Online tutorial. 
Before we go any further, let’s take a closer look 
at your display screen. 
Understanding Your Display Screen 


Your display screen is divided into three major 
areas: 


Select the color setting desired by wsing the color coded keys. 
WSCTRL SETUP CBLOR BKCHD WINDOAEA SCREER-2 og 
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The application window area contains the 
screen profile you are using. 


The message line/user prompt area displays 
messages that tell you when your IBM 3270 
Personal Computer is having problems; the 
prompts provide you with guidance. You 
can remove a message from the message 
line/user prompt area by pressing the Reset 
key. Prompts will help guide you through 
the autokeying, copying, and color change 
key sequences. The messages and their 
meanings can be found in Appendix E. 


The operation information area gives you in- 
formation about the status of your session. 
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Using Help Panels 


You can press the Help key to find out which 
functions are active. You can use Help only in 
work station control mode. Help overlays the 
right side of your screen with a list of active 
functions. The small box on the Help panels indi- 
cates a window. To clear the Help panel from 
your screen, press the Help key again. Watch 
how the following panels can help you size a 
window using the SetUp function. 


First, press Help: 


B--HOST2: 


WSCtrl 
Quit 


Print 


WSCTRL WINDOW=B SCREEN=3 


The Help panel indicates that PF2 is the correct 
key to press to get to SetUp, so you press PF2: 
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WINDOW=B SCREEN=3 ° 


The SetUp Help panel indicates that PF 12 is the 
correct key to press when you want to size a win- 
dow, so you press PF 12: 
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Del O 
PF 1 


WSCTRL «SETUP SIZE WINDOW=B SCREEN=3 


The Help panels show the specific keys you must 
press to change the size of your window. Notice 
that you also can see what other functions are 
active at this point. 
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Listing Screen Profiles, Windows, and 
Autokey Recordings 


When you are in work station control mode, you 
can press PF1(List). List overlays the right side 
of your screen with a list of window names and 
the windows assigned to each of your ten screen 
profiles. The current screen profile is highlighted 
in reverse video; your current selected window is 
also highlighted. While List is displayed, you 
cannot perform any other function. In order to 
continue to do work, you must remove List from 
the display screen. To do this, press PF 1(List) 
again. Below is a sample List panel:. 


WINDOW=B SCREEN=3 
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You can also use List when you are in autokey. 
The right side of your screen will be overlaid 
with a list of your autokey recordings, including 
names, lengths, and the amount of space remain- 
ing in computer storage for additional autokey 
recordings. Again, while List is displayed, you 
cannot perform any other function. In order to 
continue to do work, you must remove List from 
the display screen. To do this, press PF 1(List) 
again. 


Online Tutorial 
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We suggest that you now use HELPER. It is an 
easy-to-use tutorial diskette that will acquaint 
you with your new work station and the control 
program. Refer to the tutorial booklet for in- 
structions on how to load the diskette and to use 
HELPER. 


Remember that, while you are using the IBM 
3270 Personal Computer, you can keep the 
tutorial active as the personal computer session. 


Other Functions 


As we mentioned before, the IBM 3270 Personal 
Computer provides you with a variety of func- 
tions designed to meet your specific needs. These 
functions are briefly covered here. 


Browsing the Contents of Your 


Presentation Space 
When you are in work station control mode, you 
can browse the contents of your presentation 
space. This is a useful function when you are 
looking for specific information in your window. 


Browsing is described in Chapter 8. 


Copying Information 
You can copy information: 


@ From one area to another within the same 
window 


@ From a window to another window on the same 
screen profile 


@ From a window on one screen profile to a 
window on another screen profile 


@ From a host, personal computer, or notepad 
window into another host or notepad window. 
The only limitation is that you cannot copy in- 
formation into a personal computer window or 
copy within the personal computer window. 


Copying is explained in Chapter 9. 
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Recording and Playing Keystrokes 


You can use the autokey function to record a 
sequence of keystrokes and play them back. For 
example, you may want to record a frequently 
used logon procedure or a memo introduction. 
After you record the keystrokes, you can perma- 
nently save the recording on diskette or fixed 
disk for future use. If you choose not to save the 
recording permanently, you can play it back 
until you turn off the work station. The work 
station maintains a list of your recordings for 
you. 


Autokeying is fully explained in Chapter 10. 


Saving and Restoring Information 
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You can save autokey recordings, notepad infor- 
mation, and screen profiles. You do this in your 
active personal computer window. Suppose, for 
example, that you were working with a screen 
profile at the end of a day and had to turn off 
your work station. If you did not save that 
specific window arrangement, you would have to 
rearrange it the next time you turned on your 
work station. The save and restore commands 
allow you to save your screen profile perma- 
nently and restore it when you resume work. 
This is also true of information in your notepad 
and autokey recordings. 


Save and restore commands are discussed in 
Chapter 11. 


Printing Screen Profiles and Sessions 


You can print on an IBM 3270 Personal Com- 
puter supported locally attached printer or on a 
printer attached to your IBM 3274 Control Unit. 


Using your IBM locally attached printer, you 
may want a hardcopy of your schedule in the 
notepad window. You may want to print a screen 
of information from your personal computer or 
host session; or you may want to print an exact 
duplicate of a screen profile. 


If you want to print the contents of any of your 
host sessions, you may decide to print them on a 
3274-attached printer. Only host session infor- 
mation can be printed directly on a 3274- 
attached printer. You can use file transfer (see 
below) and a host program to print additional in- 
formation from your IBM 3270 Personal Com- 
puter on a 3274-attached printer. 


Printing is discussed in Chapter 12. 


Transferring Files 


If you have the IBM host-supported file transfer 
program, you can transfer files between a VM/ 
CMS or TSO host and the personal computer. 
For example, files containing statistical data 
from the host can be transferred to the personal 
computer. Then, programs written for the per- 
sonal computer can analyze this data and dis- 
play or immediately print results on the IBM 
3270 Personal Computer printer. 


Transferring files is discussed in Chapter 13. 
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Notes: 
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Introduction 


This chapter is for anyone who needs to load a 
customized system diskette. This chapter 


discusses: 

@ Information about diskettes 

@ How to handle diskettes 

@ How to insert diskettes 

@ How to load the control program on the cus- 
tomized system diskette into computer 
memory 

@ What is on your display screen: Screen 
Profile 0 

@ How to save Screen Profile 0 

@ How to restore Screen Profile 0 

@ How to remove diskettes. 


You will usually want to load the control pro- 
gram when you start your computer. 


For further information concerning switching 
your system unit to On or Off, see the IBM 3270 
Personal Computer Guide to Operations. 
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Terms You Need to Know 


Diskette 


Load 


A thin, flexible magnetic medium 
and a semi-rigid protective jacket 
in which the diskette is perma- 
nently enclosed. 


To read a copy of the control 
program from the customized 
system diskettes into work 
station storage. 


About Diskettes 


A permanent protective jacket contains a 
flexible diskette that is coated with a magnetic 
substance. The diskette spins inside the jacket 
when in use. The read/write head in the system 
unit comes into contact with the diskette surface 
through the long hole called the head slot. Infor- 
mation may be: 


@® Written to or read from the magnetic sur- 
face of the diskette, similar to the way a 
tape recorder operates 
Read by the computer as often as needed 
Replaced by new information. In this case, 
old information is erased by writing over it 
with new information. 


We suggest you use double-sided, double-density 
diskettes. 


Temporary Label Write Protect Notch 
(Some diskettes do 


not have this notch.) 
Permanent 
Label 5 
~ ———, Exposed Recording 
Surface 
Diskette in 


(DO NOT TOUCH) 
Permanent 


Protective 
Jacket 


Head Slot 


es Diskette 


Envelope 
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How to Handle Diskettes 


Because a diskette can be easily damaged, you 
need to be especially careful when handling it. 
You can lose information that has been recorded 
on a diskette. Also, a damaged diskette may not 
record new information. Follow these steps 
before you insert or remove a diskette from a 
disk drive. 


1. The label appears at the upper edge of the 
diskette. Grasp that upper edge and remove 
the diskette from the paper envelope. Be 
careful not to touch any areas where the 
diskette surface is exposed. 


2. Place the paper envelope in a safe place. 
When you are finished using the diskette, 
put it back in its envelope. 


3-6 


Loading the Control Program 


Starting or loading the control program means 
that a copy of the program is read from the cus- 
tomized system diskette into the computer’s 
memory. There are two ways to load the control 
program. How it is loaded depends on whether 
your IBM 3270 Personal Computer is off or on. 


If Your IBM 3270 Personal Computer 


Is Off 


1. 


Zz: 


Open the diskette drive cover in drive A. 


Grasp the upper edge of the diskette with 
the label facing up and near your body. 


Insert the diskette into drive A and close 
the diskette drive door. Do not force or bend 
the diskette. 


Note: If you are using a fixed disk, keep the 
diskette drive door open. 


Switch the display to On if necessary. 
Switch the system unit to On. 

There will be a pause while the system 
checks itself out. In addition, you will see 


the diskette drive ‘‘in use’ light on. 


You will then see the name of a module flash 
on the display screen. 
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If Your IBM 3270 Personal Computer 


Is On 
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Open the diskette drive cover in drive A. 


Grasp the upper edge of the diskette with 
the label facing up and near your body. 


Insert the diskette into drive A and close 
the diskette drive door. Do not force or bend 
the diskette. 


Note: If you are using a fixed disk, keep the 
diskette drive door open. 


Press and hold Ctrl and Alt, and then press 
Del in the numeric keypad area. Release 
them all. 


There will be a pause while the system unit 
checks itself out. In addition, you will see 
the diskette drive ‘‘in use”’ light on. 


You will then see the name of a module flash 
on the display screen. 


What Is On Your Display 
Screen: Screen Profile 0 


At this point, you have loaded the control pro- 
gram. Now the screen displays the IBM 3270 
Personal Computer logo in the personal com- 
puter window on Screen Profile 0. Since your ac- 
tive window is the personal computer window, 
your keyboard functions as a personal computer 
keyboard. The enter key you use can be either 
the New Line key, ¢ , or the Enter key in the 
Typewriter Key area. All other windows that 
have been configured for Screen Profile 0 are 
covered by the personal computer window. When 
the window covers the whole display screen, you 
do not see the window borders. Your screen 
should look like this: 


COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 1983, 1994 
IBM 3270PC CONTROL PROGRAM LEVEL 1.16 


You are now in application mode. This is the PC window on Screen Profile 0 
lt hides all other windows. Window borders DD NOT show. You can 


) Use the PC session: Enter a DOS command at the DOS prompt (bottom line) 


} Hake any other window on Screen Profile © active: Press Jump key. The OI¢ 


1A OF 


the bottom tine will show the Short Name of the displayed active wi 


ndow 


) Display the list of windows and screens for your configuration: Press WS ( 
key, then press List key (PF1). 


) Display the list of active functions: Press WS Ctrl key, then prese Hel; 


4) 


Loading the Control Program 3-9 


3-10 


Remember that your personal computer window 
covers the other windows because it is on top. 
Conceptually, it might look like this: 


a 


First, the IBM 3270 Personal Computer logo ap- 
pears. Let’s take a closer look at the information 
that appears below the logo. 


1) Use the PC session: enter a DOS command 
at the DOS prompt (bottom line). 


If you want to do work in the personal computer 
session, you can enter a DOS command at the 
DOS prompt at the bottom of the display screen. 


2) Make any other window on Screen Profile 0 
active: press Jump key. The OIA on the bot- 
tom line will show the short name of the 
displayed active window. 


All other windows on Screen Profile 0 are cov- 
ered by the personal computer window. Use the 
Jump key to jump from one window to the next. 
The operator information area (OIA) shows the 
short name of the active window that is now on 
your display screen. 


3) Display the list of windows and screens for 
your configuration: press WS Ctrl key, then 
press List key (PF1). 


The List function overlays the right side of your 
screen with a list of window names and the win- 

dows assigned, if any, to each of your ten screen 
profiles. The current screen profile is highlighted 
in reverse video; your current selected window is 
also highlighted. To clear your screen of the List 


panel, press PF1 again. 


4) Display the list of active functions: press 
WS Ctrl key, then press Help key. 


The Help function overlays the right side of your 
screen with a list of active functions. To clear 
the Help panel from your screen, press the Help 
key again. 


Since Screen Profile 0 appears as full screens, 
you will need to go to Chapter 7 to size your 
windows. You can also change colors and move 
windows at this time. Return to ‘‘How to Save 
Screen Profile 0” in this chapter after you finish 
sizing and moving windows. 


Chapter 7 also describes how to layout other 
screen profiles. The basic procedure is: 


1. Go into work station control mode 

2. Select the screen profile you want to use 
3. Add a window from Screen Profile 0 

4. Setup the window size, location, and color. 


5. Add another window from Screen Profile 0 if 
necessary. 


You may have a customized system diskette 
that does not include a personal computer ses- 
sion. If this is the case, both the IBM 3270 Per- 
sonal Computer logo and information below the 
logo do not appear. What does appear is the full 
screen active window without borders. The oper- 
ator information area tells the short name of this 
active window. Since you are in application 
mode, you can: 


1. Enter information into the active window 
2. Jump to another window 


3. Press WS Ctrl to enter work station control 
mode. 


Loading the Control Program 3-11 


How to Save Screen Profile 0 


After you have sized all windows on Screen Pro- 
file 0 according to the procedures in Chapter 7, 
you can permanently save the arrangement. 
Make sure your customized system diskette is in 
diskette drive A. Since the Save command can 
be used only while the personal computer session 
is active and the DOS command prompt, for 
example, A> , is on the screen, you need to: 


1. Select the personal computer session, using 
the Jump key or the short name 


2. Press WS Ctrl 

You are now in application mode. 
3. At the DOS prompt, type 

indsave screen 
4. Press Enter or New Line key, ¢ . 


At this point you will see the following 
messages: 


SR001 Save command being processed 
SR006 Screen profile saved successfully 
SR007 Save processing complete 


Your screen profiles are now permanently saved. 
For further information on Save and Restore 
commands, see Chapter 11. 


How to Restore Screen Profile 0 


Assuming you have saved Screen Profile 0, you 
can also restore it at any time. If you are begin- 
ning your day’s work and are ready to load the 
control program, follow the simple procedure 
below to restore your screens. 


1. Load the customized system diskette follow- 
ing the steps under the heading ‘‘Loading 
the Control Program’’. 


2. Thecursor is at the DOS prompt at the 
bottom of the screen. 


Type 
indrstr screen 
3. Press Enter or New Line key, ¢ . 


Screen Profile 0 should appear the same way as 
when you saved it. 


There may be some of you who have created an 
autoexec.bat file that is invoked automatically 
anytime you initialize DOS. DOS is initialized 
automatically whenever you load the control pro- 
gram. By entering the appropriate Restore 
commands into the autoexec.bat file with other 
desired commands, you can set up the IBM 3270 
Personal Computer with standard screen pro- 
files, autokey recordings, and notepads. 


You can create this autoexec.bat file by using 
the EDLIN editor supplied with DOS (see the 
IBM Personal Computer Disk Operating System 
manual) or any of the other file editors available 
for the IBM Personal Computer. This file ini- 
tially contains a statement that the system 
supplies at the conclusion of the customization 
task. Do not alter or remove this name. You may 
include other statements such as TIME, DATE 
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or other supported DOS commands as long as 
they follow the statement that the system sup- 
plies. Thus, to automatically restore your 
screens, add this line to the autoexec.bat file 
following the statement supplied by the system: 


indrstr screen 
Then, when you load the control program: 


1. The IBM 3270 Personal Computer logo ap- 
pears 


2. At the DOS prompt, the command indrstr 
appears and executes automatically 


3. Your restored screen profile automatically 
appears. 


See Appendix F for further information on 
autoexec.bat files. 


How to Remove Diskettes 
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Follow these steps when you need to remove a 
diskette from a diskette drive. 


1. Open the diskette drive cover on drive A. 
2. Grasp the edge of the diskette. 


3. Slowly pull the diskette straight out of the 
diskette drive. 


4. Return the diskette to its paper envelope. 
Place the diskette in a safe place to prevent 
damage. 


5. Keep the diskette drive door open. 
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Introduction 


This chapter is for anyone who uses the key- 
board. It describes: 


@ Terms you need to know 


@ What this keyboard does 


@ Special kinds of keys. 


Terms You Need to Know 


Application mode 


Work station 
control mode 


Toggle 


When you are in appli- 
cation mode, your key- 
board is ‘‘attached”’ to 
one of the following: a 
host computer session, 
the personal computer 
session, or a notepad 
session. 


Work station functions 
are initiated from this 
mode. You access and 
quit this mode with the 
(work station control) 
WS Ctrl key. 


Press a key once and it 


is active; press it again 
and it is inactive. 
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What This Keyboard Does 
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The IBM 3270 Personal Computer provides you 
with host, personal computer, and notepad ses- 
sions. Not only can you work in these different 
sessions, but you can adapt your display screen 
to meet specific needs. The keyboard is your tool 
for accomplishing these functions: you communi- 
cate with these sessions through the keyboard. 


Application mode consists of host, personal 
computer, and notepad sessions. You can enter 
information only while you are in one of these 
sessions. This means your keyboard is attached 
to a specific session: 


@ Host session 
@® Personal computer session 
@® Notepad session. 


When you use your IBM 3270 Personal Com- 
puter to perform screen management functions 
such as adding color, creating windows, copying 
from window to window, and autokeying, your 
keyboard operates in work station control mode. 
Thus, you have the functions of four keyboards 
converged onto one: a host computer keyboard, a 
personal computer keyboard, a notepad key- 
board, and a work station control keyboard. 


Remember that the following keys are always 
valid in either application or work station con- 
trol modes. 


@® ws Ctrl 


@® Jump 


@ ChgSc 


@® Enlarge. 


Let’s take a closer look at the IBM 3270 Per- 
sonal Computer keyboard. First, identify the five 
areas on your keyboard: 


1 


2. 


Left control keys 
Typewriter keys 
Right control keys 
Numeric keypad 


Program function keys. 
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Left Typewriter Keys Right Numeric Keypad 
Control Control 
Keys Keys 


The left control keys look similar to those on 
other keyboards you may have used, for exam- 
ple, IBM 3278 or 3279 keyboards. Four much- 
used keys in this area are: 


@® WS Ctrl 
® Jump 

@® ChgSc 
@® Enlarge. 


The program function keys are additions to the 
keyboard. On a 3278 keyboard, for example, you 
would have seen this area on the far right; we 
have moved it to the top of your keyboard. A 
template fits around the program function keys 
and shows which keys function only in work 
station control mode. 


The typewriter keys are very similar to those on 
other keyboards. An extra Alt key to the left of 
the spacebar provides you with easy access for 
combination keystrokes that require Alt plus 
another key. 


The right control keys contain the same func- 
tions as those on other IBM 3278 or 3279 
keyboards. 


The numeric keypad is familiar to personal com- 


puter users. This is a feature that makes it easier 
for you to do calculations. 
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Special Kinds of Keys 
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You will notice that some of the keys have more 
than one function. 


@ A function printed on the top of the key in 
the top position is used with the Shift key. 


@ A function printed on the top of the key in 
the bottom position is not used with any 
other key. 


if 


@ A function printed on the front of the key is 
used with the Alt key. 


f= §=—9Y OU Jet the function in lowercase. 


[ crsei \ aes Praecnanold (Alt) for this function. 


Notice the blue lettering on some key tops. This 
blue lettering indicates that the function is ac- 
tive only during a personal computer session. 


ChgSc Press and hold{ A\ ](shitt) for this function. 
Jump 


Toggle Keys 


Toggle keys are like light switches: you press 
them once to turn them on and activate a func- 
tion; you press them again to turn them off 
and deactivate a function. The following are 


examples of toggle keys: 


(res Browse (PF3) 


5 CapsLock 
en 


Enlarge 


Press Browse 

to move data 
contained in the 
presentation space 
vertically or hor- 
izontally within a 
window. Press 
again to deactivate 
the browse 
function. 


Press when you are 
in a personal com- 
puter session and 
you will have all 
capital letters. 
Press again for 
uppercase and 
lowercase letters. 


Press to enlarge a 
window so that it 
displays the presen- 
tation space to the 
maximum size 
allowed by the dis- 
play. No other win- 
dows appear. Press 
again and your win- 
dow is back to its 
former size. The 
other windows then 
appear. 
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Help 


Help 


Ins (Insert) 


List 

PFI 
NumLk 
Pause 


Copy 


Auto | 


Press to overlay the 
screen with Help in- 
formation. Press 
again to remove 
that information. 


Press when you are 
in a personal com- 
puter session so 
you can insert char- 
acters. Press again 
to insert informa- 
tion no longer. 


Press to overlay the 
screen with infor- 
mation about 
screen profiles and 
autokey records. 
Press again to 
remove that 
information. 


Press when you are 
in either a personal 
computer or host 
session and you will 
have numbers on 
the numeric key- 
pad. Press again to 
deactivate the num- 
bers and to get the 
other functions on 
those keys, such as 
Home and End. 


Press when you are 
using the autokey 
function; it allows 
you to pause. Press 
again to resume 
recording. 


SetUp Press when you 
Pra | need to go into 
SetUp and either 
[se \ size, Move, corner, 
hide, or change 
colors of your 


windows. Press 
again to leave 


SetUp. 
WS Ctrl Press to go into 
WS . 
Ctrl work station con- 


trol mode. Press 


[xs \ again to go into 


application mode. 
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Introduction 


This chapter is for anyone who uses the key- 
board in application mode. When you are in 
application mode, your keyboard can operate 
with only one session at a time. This means: 


@® Ina host session, your keyboard functions 
as a host keyboard. 


@ Ina personal computer session, your key- 
board functions as a personal computer 


keyboard. 


@ Ina notepad session, your keyboard func- 
tions as a notepad keyboard. 


Terms You Need To Know 


Valid key 


Invalid key 


Program function 
(PF) key 


A key that is recognized by 
the session type (host, per- 
sonal computer, notepad) or 
mode (work station control 
mode or application mode) 
to which your keyboard is 
logically attached 


A key that is not operational 
A key that passes a signal 


to a program to call for a 
particular operation. 
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Host Computer Functions 


When you have an active host window, your key- 
board supports host functions. It functions as a 
host computer keyboard. It can emulate all the 
key functions of a 3278 or 3279 keyboard. For 
further information on the keyboard, see the 
IBM 8270 Information Display System 8278 Dis- 
play Station Operator’s Guide, GA27-2890. 


The 5271 Keyboard 


SPEERSEEERER 
FIPFEEERFEREE 
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BIE] RUHRARHARRRRAEHER HE 

BE GARAARRAARAAAR— Bee etl 
FAN feQ QE ———}F0 feu HO EGR 
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Left Typewriter Keys Right Numeric 
Control Control Keypad 
Keys Keys 


Host Computer Keys in the Left 
Control Key Area 


ooo000oRo0o0000 


Chgse) “Press or noid A]ishiny for this function Oooo0ononoooo 


ee 9You get the function in lowercase. 


[ cxset \ de Press and hold (Alt) for this function an OoocooOooOoOoOoOoDoON 


Clear 
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@m Ooooo000000oo0 
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0000 
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For those of you who are old hands at the 3278 
or 3279 keyboard, these key functions will look 
familiar. For you who are new to these functions, 
take a few minutes to become familiar with 
them. The following list is a summary of host 
keyboard functions in the Left Control Key area: 


Host Computer 


Key 


Test 


SysRq 


Clear 


Function 


Signals the host. 


Erases all of the 
active session ex- 
cept the operator 
information area 
and moves the 
cursor to the first 
input character 
position. It also 
signals the host. 


Prepares your 
work station to 
run special prob- 
lem determina- 
tion functions 
that reside in the 
control unit if 
your 3270 Per- 
sonal Computer 
is customized to 
operate as a con- 
trol unit terminal 
(CUT). For more 
information, see 
Appendix A. 


WS Ctrl 


ExSel 


Attn 


ChgSc 


Jump 


Puts you in work 
station control 
mode. Can be 
pressed in appli- 
cation and work 
station control 
modes. Press WS 
Ctrl again to go 
to application 
mode. 


Configures your 
host computer 
keyboard func- 
tions to emulate 
certain type- 
writer features. 


Signals the host. 


Changes from 
defined screen 
profile to another 
defined screen 
profile in numeric 
sequence. Can be 
pressed in appli- 
cation and work 
station control 
modes. 


Jumps from win- 
dow to window 
in alphabetic se- 
quence. Can be 
pressed in appli- 
cation and work 
station control 
modes. 
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CrSel 


Erase EOF 


ErInp 


Print 


Chooses fields for 
processing. The 
cursor must be in 
a field that your 
application has 
designated for 
cursor selection. 


Erases the input 
field from the 
cursor to the end 
of the field. The 
cursor does not 
move. 


Erases all the in- 
put fields in the 
active session 
and moves the 
cursor to the first 
input character 
position on the 
display screen. 


Sends data from 
the active session 
in the work sta- 
tion to a printer 
attached to an 
IBM 3274 Con- 
trol Unit. 


Ident Signals that the 
next two num- 
bers will be the 
selected printer 
ID code. The ID 
is displayed in 
the operator in- 
formation area. 
This key is also 
used to display 
the new ID when 
your printer 
assignment is 
changed. 


Enlarge Makes the 
selected and sub- 
sequent windows 
as large as can be 
physically dis- 
played on your 
display screen 
until toggled off. 
Can be pressed in 
application and 
work station 
control modes. 
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Reset 


Used to recover 
from most Do 
Not Enter (X) 
conditions. The 
Do Not Enter 
symbol (X) ap- 
pears in the oper- 
ator information 
area. This key 
terminates an in- 
sert mode opera- 
tion. In addition, 
it restores the 
keyboard and 
turns off the Do 
Not Enter sym- 
bol for all Do Not 
Enter conditions 
except: 


@® Printer busy 


@ Printer very 


busy 
@ Printer not 
working 
@ Wait. 


Host Computer Keys in the 
Typewriter Key Area 


ChgSc —_——— Press and notd{ A ]fshitt) for this function. OoOooooo00000 
Jump ee ———— You get the function in lowercase. goocoooo0o000 
[ crsat \ <————— Pres endrotafAn] 0 forts tureton, =O OOO Oooo 


05 SSRReeeeeeeees OOO Oooo 
DO SESERReeeeeeee oo000 
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Most keys in the typewriter key area are active 


host computer keys. All the alphabetic and 


numeric keys work. Notice that the numbers 1 
and 6 contain two sets of engravings. 


@ The black engravings indicate host com- 
puter functions. Thus, Shift + 1 produces 
‘|?’ Shift + 6 produces “ ”’. 


@ The blue engravings are personal computer 
unique functions. 


The following list describes certain keys in the 
Typewriter Key area: 


Host Computer 


Key Function 

45 Tab Moves the cursor 
to the first char- 

eas acter location of 
the next unpro- 
tected field. 

Backspace Moves the cursor 
one location to 

ae the left each time 
you press the 
key. This key is 
typamatic. 

e New Line Moves the cursor 


to the first unpro- 
tected character 
location of the 
next line in which 
you can type. 
This new cursor 
position depends 
on the existing 
data displayed 
and on the screen 
format. 


ee 


A space is an ac- 
tual character 
that occupies a 
position on your 
display screen. 
When you press 
this key, you 
enter a space 
character that re- 
places whatever 
character was in 
that position. For 
this reason, do 
not use it to posi- 
tion the cursor. 
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Host Computer Keys in the Right 


Control Key Area 


ChgSe 


Jump fee YOU GCL The funcuan in lowercase 


[ crsei \ Press and Hold (Ald for thus function, 


Dup Field 
Mark 
PA1 PA2 


5-14 


Press and nord 4 Jisrity for this function 


onooooooooono 
ooo0oooooo0o0o00 


Dooooooeooonoo 
OnooooooOooosoo 
OoonoooRooooooo 
oonooooooseono 
Onoonoooooo0o0o0o 


o0o00 
0000 
O000 
Ooo000 
oo000 


Other host computer keys are found in the Right 
Control Key area. These include: 


Host Computer 
Key 


PA1 - PA3 


Field Mark 


Tab left 


Function 


Provides a means 
of signaling a 
program or com- 
municating with 
it. It displays the 
dup character on 
the display 
screen. 


These program 
attention keys 
provide a means 
of signaling a 
program or com- 
municating with 
it. 


Provides a means 
of signaling a 
program or com- 
municating with 
it. It displays the 
field mark char- 
acter on the 
display screen. 


Moves the cursor 
to the previous 
unprotected field. 
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Insert 


Delete 


Sets the key- 
board to insert 
mode so that | 
characters will be 
entered at the 
cursor position 
and all data to 
the right of the 
cursor will move 
to the right. 


Removes the 
character occupy- 
ing the position 
underlined by the 
cursor. It erases 
the character 
without leaving a 
blank. All charac- 
ters in the field to 
the right of that 
position and on 
the same line are 
then shifted left 
one position. This 
is a typamatic 
key. 


Arrows that con- 
trol the up, down, 
left, and right 
movements of the 
cursor. In addi- 
tion, if you hold 
down the right 
cursor movement 
key, —> , the 
cursor wraps or 
moves off the 
right side of the 
line and reap- 
pears one line 
lower on the left 
side. It also 
wraps when you 
hold down the 
left cursor move- 
ment key, ¢ . 
In this case, 
when it moves to 
the left, it reap- 
pears one line 
higher on the 
right side. Re- 
member that the 
cursor is the 
marker on the 
screen that 
shows you where 
the next charac- 
ter on the screen 
will be entered, 
replaced, or 
deleted. 


Notice that 
pressing either 
Alt + @ or 
Alt + —» gives 
you faster cursor 
movement. 
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Home 


Alt + (the 
center key) 
moves the cursor 
to the home posi- 
tion, the first 
input character 
position. 


Host Computer Keys in the Numeric 
Keypad Area 


Press and notd{ A Jishitt) for this function. oOnoooRoooOoo0o0a 
Ea pene |= You get the function in lowercase. Q0o0000 ooo000n0o0 
| crsat \ Press and hold (Ait) tor this function. 
00 goOonoo0o0oo0n0o0000 OOO sae 
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00 oooooooo0ooOooonoO Oa uaee 
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All the keys are active in the numeric keypad 
area, but some of the functions work only during 
a personal computer session. You can use the fol- 
lowing functions on the numeric keypad: 


@ Numbers 0 through 9 are positioned left to 
right, bottom to top 


@ Decimal point, a comma, a space key. The 
space key works like the space bar in the 
Typewriter Key area. 


@® Hyphen/minus symbol: - 


@® Tab right key —® to help you align columns 
of figures 


An Enter key 


NumLk. This is a toggle key. Pressing it 
once activates the numeric lock function; 
pressing it again deactivates it. When the 
numeric lock is active, the only valid keys 
you can use in an unprotected numeric field 
are 0-9,., Dup, and -. You can override the 
numeric lock by pressing and holding the 
Shift key while typing; this allows you to 
enter any upper shift characters. 


Host Computer Keys in the Program 
Function Key Area 


Press and nota{ A] ishites for this function. PTTITITTiittii i 
oe §=9YOU get the function in lowercase. 


Tritt tt tl 
Press and ho! {Alt} for this function. 
[set \ msangnorafan (AM fortis tween, onggooooogooo Goo Oooo 


O00 gQoooon000o0o0ooo oOo ooo00 
0O ooooonoooooooo 68 oO000 
O00 ooooo00000o0000 obo oooo 
O35 oooooooonoNoo0o0o0 a o000 
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At the top of your keyboard there is a complete 
set of 24 Program Function (PF) keys. Since the 
meanings of program function keys always vary 
from application to application, they will not be 
discussed here. Notice, however, the following 
functions that appear on the keys and are active: 


Host Computer 


Key 


PSA-PSF 


Function 


The Programmed 
Symbol set fea- 
ture stores under 
host program 
control up to six 
character sets or 
fonts which have 
special font sym- 
bols. These are: 
PSA, PSB, PSC, 
PSD, PSE, and 
PSF. The applica- 
tion program in 
the host deter- 
mines if you can 
select a Pro- 
grammed Symbol 
set. It may not 
be available at 
your installation. 
In addition, the 
following may 
not be available: 
Highlighting 
selection 
Color selection 


To select the font 
you want your 
characters dis- 
played from, 
press PF1-PF6. 
For further infor- 
mation, see the 
IBM 8270 Infor- 
mation Display 
System 8274 
Control Unit 
Description and 
Programmer’s 
Guide and 
Appendix H. 


(PF7) Use this key to 
ad return to the 
default symbol 
font. 


(PF9) Selects reverse 
E} video highlight- 

ing for char- 
acters. The char- 
acter entered will 
be highlighted by 
reversing the 
color of the char- 
acter and its 
background. For 
example, a char- 
acter of green on 
a black back- 
ground will be 
displayed as a 
black character 
on a green back- 
ground. This kind 
of highlighting 
depends on the 
application you 
are using. 
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(PF 10) 


74S 


(PF 11) 
a 


(PF 12) 
2d 


PF13-PF19 


Selects blink 
highlighting for 
characters. The 
character entered 
will be high- 
lighted by 
blinking on and 
off. This kind of 
highlighting 
depends on the 
application you 
are using. 


Selects under- 
score high- 
lighting for | 
characters. The 
character entered 
will be high- 
lighted by an un- 
derscore beneath 
the character. 
This kind of high- 
lighting depends 
on the applica- 
tion you are 
using. 


Use this key to 
return to base 
highlighting. 


Use to select 
seven-color 
support. 


(PF21) 
se 


(PF23) AltCr 


Use this key to 
return to base 
color. 


Allows you to 
select which type 
of cursor appears 
on your screen. 
Initially you get 
the normal, or 
default, cursor. It 
is an underscore. 
Then, as the cur- 
sor rotates ina 
‘round robin” 
fashion each time 
you press this 


key, you get: 
@® Blinking 
underscore. 


@ Reversal of 
the color of 
the character 
and its back- 
ground. The 
cursor looks 
like a small 
box. 


@ Reversal of 
the color of 
the character 
and its back- 
ground and 
simultaneous 
blinking. The 
cursor looks 
like a small, 
blinking box. 
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You can think of a notepad as one sheet of paper 
on which you can write notes to yourself, much 
like you would do with a piece of scratch paper. 
It is the same size as your display screen. What 
can you do with a notepad window? 


@ Size it 

@ Move it 
@ Corner it 
@ Hide it 


@ Change its colors 


In addition, if you hold down the right cursor 
movement key, ~— , the cursor wraps or moves 
off the right side of the line and reappears one 
line lower on the left side. It also wraps when 
you hold down the left cursor movement key, 

¢ .Inthis case, when it moves to the left, it 
reappears one line higher on the right side. 


When your keyboard is attached to a notepad 
session, that is, when a notepad window contains 
the cursor, your keyboard functions as a notepad 
keyboard. As a general rule, your notepad key- 
board behaves very much like a host computer 
keyboard, but with certain exceptions. The fol- 
lowing is a list of keys that are active in a 
notepad session. For information on how the 
active keys in a notepad session work, see ‘‘Host 
Computer Functions’’ in Chapter 5. 


Notepad Keys in the Left Control 
Key Area 


The following list describes keys that are active 
in a notepad session. 


1. 
2. 


3. 


6. 


Clear 
WS Ctrl 
ChgSc 
Jump 


Erase EOF (works only on the line 
containing the cursor) 


Enlarge 


Notepad Keys in the Typewriter 
Key Area 


All the host computer keys, except the tab key, 
are active. 


Notepad Keys in the Right Control 
Key Area 


The following keys are active: 


i. 


a 


Tab left 


Insert (works only on the line containing the 
cursor) 


Delete (works only on the line containing the 
cursor) 
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4. Cursor movement keys, including double- 
speed cursor keys 


5. Home 


If you first press Insert and then press the back- 
space key found in the Typewriter Key area, that 
backspace key goes back to the previous charac- 

ter and deletes it. 


Notepad Keys in the Program 
Function Key Area 


The following keys are active: 


1. Highlighting functions 
a. Alt + PF9, PF10, PF11, PF12 


2. Color functions 
a. Alt + PF13-PF19 
b. Alt + PF21 


3. Alt + PF23 


Typing in Technicolor with PF Keys 


5-28 


When you are in a notepad session, you can set 
color while you are in application mode and type 
in technicolor. You use the color keys, PF13 
through PF19, in the Program Function key 
area. Here’s how to do it: 


1. Go into application mode. If some techni- 
color data already exists in the notepad win- 
dow and you try to change colors while you 
are in work station control mode, you get a 
message stating: 


MSG029 Color setting override: changes 
may not show 


2. Press one of the color keys, PF13 through 
PF 19, for the color you want for the next 
character. 


3. The window will have a black background 
and blue borders after you type the first 
character. The characters continue to be 
typed in the color you chose. 


4, Whatever color you chose is the color you 
will type in the notepad window. The color 
you chose shows in the operator information 
area. 


5. Want to change color? Press another color 
key, PF13 through PF19, to choose another 
color. 


6. You can turn off color by pressing Alt + 
PF21. When you type now, characters 
appear in green, the default color. 


If you clear the window by pressing the Clear 
key, your window goes back to base mode. Any 
characters you type now appear as the default 
foreground color. For further information on 
color, see Chapter 7. 
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When your keyboard is attached to a personal 
computer session, that is, when your personal 
computer window contains a cursor, your key- 
board functions as a personal computer key- 
board. Thus, it can perform all the functions of 
an IBM Personal Computer keyboard. In the 
personal computer session, use the New Line 
key, _ , or the Enter key in the Typewriter 
Key area to enter data or commands. 


Personal Computer Keys in the Left 
Control Key Area 


onoooboo000000 
ChgSe Press and nota A Jisnite) tor this function. opo0oDoOooOoOoOoOoO 
Jump [ ——_——————-._ You get the function in fowercase. 
[ cxset \ te Press and hold {Ait} for this function. an QOO0oO8R08o0no05 ooo O00 


Sm OoOoooooodoooo80 ooo OOO 
@e ooonooooocooooo 6B 000 
Be oooooonooooo0o0o ooo OOO 
Be moooooooooooooH Oo OOO: 


Reset 
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Personal computer keys located in this area are: 


Personal 
Computer Key 


SysRq 


WS Ctrl 


Function 


Allows the per- 
sonal computer 
window to 
become blank 
whenever the per- 
sonal computer 
application re- 
quests its display 
to blank. Press 
again if you want 
these requests to 
be ignored. See 
Appendix G for 
more details. 


Puts you in work 
station control 
mode. Can be 
pressed in appli- 
cation and work 
station control 
modes. Press 
again to go to 
application mode. 


Ctrl + WS Ctrl In application 
mode, press when 
you are in a per- 
sonal computer 
session. Then the 
operator informa- 
tion area overlays 
the last line of 
your display 
screen. If your 
cursor happens to 
be at the last line 
of the display 
screen, it will no 
longer appear, 
but will be over- 
laid with the 
operator informa- 
tion area. You 
can toggle the 
personal com- 
puter session 
operator informa- 
tion area off by 
pressing Ctrl + 
WS Ctrl keys 
again. Your cur- 
sor will again 
appear. 


ChgSc Changes from 
defined screen 
profile to defined 
screen profile in 
numeric se- 
quence. Can be 
pressed in appli- 
cation and work 
station control 
modes. 
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Jump 


Print 


Jumps from win- 
dow to window in 
alphabetic se- 
quence. Can be 
pressed in appli- 
cation and work 
station control 
modes. 


Prints the con- 
tents of the per- 
sonal computer 
presentation 
space. However, 
certain charac- 
ters may not 
print on the 
printer exactly as 
you see them in 
your window or 
they may print as 
blanks; for exam- 
ple, the ‘“¢”’ sign 
and some Pro- 
grammed Symbol 
set characters. 


Displays an 
asterisk (*) in 
your active 
window. 


Enlarge Makes the 
selected and sub- 
sequent windows 
as large as can be 
physically dis- 
played on your 
display screen 
until toggled off. 
Can be pressed in 
application or 
work station con- 
trol modes. 


Ctrl Used with an- 
other key to per- 
form a command 
or a function. 


Quits the 
print operation 
occurring in a 
personal com- 
puter window. 
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Personal Computer Keys in the 
Typewriter Keys Area 


Chase Press and hotd{ 4 Jishift} for this function. ooooonooonon 
——— You get the function in lowercase. nooooaooRnAoo 
[ cese \ ee Press and hold {Alt} for this function. oo PTTTT TTY Tt. eee Dooo 
DO SREB OOO COO 
ee TT Oo ooo00 
DO SOReneneeeeees OOO ClOOoo 
DO O8SNSSeeReeeeee O o000 
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SRARARRRARASRE 
calaralaaialatalaalaesic 
paiaaaaaaaassne 
SRRSERERRRAR— 
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In the Typewriter Key area, most of your keys 
perform the same functions in host and personal 
computer sessions, with the exception of the 


following keys: 
In Host 
Computer 
and Notepad 
Key Sessions 


CapsLock 


oo U 
CapsLock 


Use to move the 
cursor from the 
last character on 
one line to the 
first character 
of the next line. 


Use as Enter for 
host computer 
sessions only. 


Does not delete 
a character. 


All keys are 
typed with 
their uppercase 
functions. — 


In Personal 
Computer 
Session 


Use as Enter 
key for personal 
computer pro- 
grams only. 


Use as Enter 
key in addition 
to the New Line 
key, ¢ 


Can delete a 
character. The 
function of this 
key depends on 
the application 
running. 


Only letters 
will be typed 
in uppercase. 
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Shift 


Pcl 


All keys are 
typed with 


their uppercase 


functions. 


@ With Shift 


only: all 
keys are 
typed with 
their upper- 
case func- 
tions. 


With Shift 
and 
CapsLock: 
all alpha- 
betic keys 
are typed in 
lowercase 
and the re- 
mainder of 
the keys 
get their 
uppercase 
functions. 


Personal Computer Keys in the Right 
Control Key Area 


ChgSc Press and notd[ A] ishite for this function. OooOoooOooD0o0o0n 
Jump ee) You get the function in lowercase, noooooo080oo 
ene Pr ind ho! if this function. 
[ cese \ eaeiere ich [aie SAU rns iy oO ooooo000000000 mae oooo 


OO oooo0oo0oo00o0ono0 see ooco 
00 ooooooo00000onG 6S 0000 
OO oooooo0o0o0o000n00 sae ooo 
OO oooo0o00co0n00000 «f O000 


Dup Field 
Mark 
PA1 PA2 PA3 
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The following keys are active in this area: 


Personal 
Computer Key 


Insert 


Delete 


Cursor 
Movement 


Function 


Sets the key- 
board to insert 
mode so that 
characters will be 
entered at the 
cursor position 
and all data to 
the right of the 
cursor will move 
to the right. 


Removes the 
character occupy- 
ing the position 
underlined by the 
cursor. It erases 
the character 
without leaving a 
blank. All charac- 
ters in the field to 
the right of that 
position and on 
the same line are 
then shifted left 
one position. This 
is a typamatic 
key. 


Arrows that con- 
trol the up, down, 
left, and right 
movements of the 
cursor. In addi- 
tion, if you hold 
down the right 
cursor movement 
key, —>, the 
cursor wraps or 


moves off the 
right side of the 
line and reap- 
pears one line 
lower on the left 
side. It also 
wraps when you 
hold down the 
left cursor move- 
ment key, q . 
In this case, 
when it moves to 
the left, it reap- 
pears one line 
higher on the 
right side. Re- 
member that the 
cursor is the 
marker on the 
screen that 
shows you where 
the next charac- 
ter on the screen 
will be entered, 
replaced, or de- 
leted. 


Notice that press- 
ing either Alt + 
or Alt + —> 

gives you faster 
cursor move- 

ment. You can 

use these keys in 
lowercase or 


with: 

@® CapsLock 
@ NumLk 

@ Shift 
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Personal Computer Keys in the 
Numeric Keypad Area 


When the keyboard is attached to a personal 


computer session, these keys function as a nu- 
meric pad, as cursor positioning keys, or as other 


functions. You switch or toggle among these 


functions with the NumLk key. 


ChgSe Press and hotd{ A] shite for this function. Ooo0o0oco0o0000 
Jump ln YOu get the function in lowercase. oo000c000000 
ne Press an r this function. 
[ cesa \ Press ai d hold [aie] (Alt) for this functio 00 OooooooocnoooD 
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7 8 9 
ff fl] 
4 6 
€ »> 
reah | ie ee 
ant eatin 
+ 


O60 gooo0ocR000Rc000 
OO oooooooRoo00oo0o8 
OO oooooco0s00000o 
DO oOooo0o000000000 


The numeric keypad allows you to enter numeric 
data. Press NumLk or Shift to get: 


@ Numbers 0 through 9, positioned left to 
right, bottom to top 


@ Decimal point, space key 
In addition, you can use these keys: 
@ Basic arithmetic symbols: + and - 


@ Tab right key —» to help you align 
columns of figures 


Below is a list of the keys you can use in a per- 
sonal computer session: 


Personal 
Computer Key Function 


Esc This function 
varies from 
application to 
application. 


NumLk Allows you to 
toggle between 
the numeric key- 
pad and the other 
functions in this 
area. 


ScrLk Depends on 
the application 
program. 
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Break 


Space 


7 Home 


Not part of the 
numeric keypad 
nor a special cur- 
sor positioning 
key. Generally, it 
halts whatever 
function is in pro- 
gress. If you are 
printing a file, 
this key will stop 
the operation. 
Use of this key 
also depends on 
the application 
program. 


Works like the 
space bar in the 
Typewriter Key 
area. 


Moves the cursor 
to the upper left 
corner of the per- 
sonal computer 
window. 


Arrow that con- 
trols the up 
movement of the 
cursor. Remem- 
ber that the cur- 
sor is the marker 
on the screen 
that shows you 
where the next 
character on the 
screen will be en- 
tered, replaced, 
or deleted. 


Tab right 


4q 


Moves the infor- 
mation contained 
in your personal 
computer window 
forward. PgUp 
depends on 
whether your 
personal com- 
puter application 
supports this 
function. 


Helps you align 
columns of 
figures. 


Arrow that con- 
trols the left 
movement of the 
cursor. Remem- 
ber that the cur- 
sor is the marker 
on the screen 
that shows you 
where the next 
character on the 
screen will be en- 
tered, replaced, 
or deleted. 


You can use the 
digit 5. There is 
no other function 
on this key. 
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6—»> 


1 End 


29 


Arrow that con- 
trols the right 
movement of the 
cursor. Remem- 
ber that the cur- 
sor is the marker 
on the screen 
that shows you 
where the next 
character on the 
screen will be 
entered, replaced, 
or deleted. 


Minus symbol or 
hyphen. 


Moves the cursor 
to the end of the 
current line. 


Arrow that con- 
trols the down 
movement of the 
cursor. Remem- 
ber that the cur- 
sor is the marker 
on the screen 
that shows you 
where the next 
character on the 
screen will be 
entered, replaced, 
or deleted. 


3 PgDn Moves the infor- 

(Page Down) mation contained 
in your personal 
computer window 
backward. PgDn 
depends on 
whether your 
personal com- 
puter application 
supports this 
function. 


0 Ins(Insert) Allows you to 
enter a character 
occupying the 
position under- 
lined by the cur- 
sor. All data to 
the right of the 
cursor moves to 
the right. 


. Del(Delete) Deletes or erases 
a character occu- 
pying the posi- 
tion underlined 
by the cursor. 


+ Plus symbol. 
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Personal Computer Keys in the 
Program Function Key Area 


ChgSc Press and notd[ A ]ishite for this function, 
Jump a YOu get the function in lowercase. 


| ceset \ ne Press and hold (Alt) for this function. 


oOonooooooooooo 
oooooooooo0noo 
Oooooono00oo000 
ooooooobo0ooooooO 
ooonooooo00000 
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0000 
o000 
oo000 
O000 
0000 


The meanings of the PF keys vary from applica- 
tion to application, but you need to be aware of 

a few points about this area of the keyboard. 
Although there are 24 program function keys, 
only PF1-PF10 and Alt + PF23 function on the 
personal computer keyboard. 


@ PF1-PF10 correspond to the F1-F10 keys 
on the IBM Personal Computer keyboard 


@ AltCr (Alt + PF23) allows you to select 
which type of cursor appears on your screen. 
Initially you get the normal or default cur- 
sor. It is a blinking underscore. Then as the 
cursor rotates in a “round robin’’ fashion 
each time you press Alt + PF23, you get 


— Blinking underscore again. 


— Reversal of the color of the character 
and its background. The cursor looks 
like a small box. 


— Reversal of the color of the character 
and its background and simultaneously 
blinking. The cursor looks like a small, 
blinking box. 


A nonblinking underscore does not appear in the 
personal computer session. 
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Station Control Mode 
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Notes: 
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Introduction 


This chapter is for anyone who wants to perform 
SetUp, browse, copy, and autokey functions; to 
add and delete windows; to use the Help and 
List panels; and to print exactly what is on the 
display screen or on an enlarged window. You 
must be in work station control mode to accom- 
plish these tasks. 

In this chapter we will focus on: 

@ Work station control mode overview 

Work station control mode functions 
Keeping track of active functions 

Levels of functions 


Selecting screen profiles 


Selecting windows 


Other work station control mode functions. 
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Work Station Control Mode 
Overview 
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In work station control mode, you can: 


Perform SetUp, browse, copy, or autokey 
functions 


Add or delete windows 
Use Help and List panels 


Print an enlarged window or exactly what is 
on the display screen. 


In work station control mode, you cannot: 


@ Type information into the window. 


Work Station Control Mode 
Functions 


Most of your work station control mode func- 
tions are found on the left control keys and on 
the program function keys at the top of your 
keyboard. Work station control mode functions 
use the host computer cursor movement keys 
found in the Right Control Key area. 


Program Function Keys 


Ease “EEE 
aaa alee 


Keypad Area 
=F) GSA Siaaiaade Jj BE PROF 
2p EEEEEDAE oF Saal AAS SESE 
ele) DAH aaa aa He A BAG 
Be) SEARO AA AREY wae 4 BAG ERE 
HA EQ oe geo 8 BSR 


Left Typewriter Keyboard Right 
Control Control 
Keys Keys 
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Work Station Control Mode Keys in 
the Left Control Key Area 


A YOu get the function in lowercase. 


ChgSc et Press and notd[ A Jism for this function 
Jump 


[ crsa \ te Press and nots [art] (Al) for this function 


e]I=} 


WS 
Ctrl 


ChgSc 
Erase 
Jump EOF 


noooooo 


oboo00000 


DoOoooOnoo 


oo0000000 
Ooo000o00 
000 


o0o000 


@oooo0o0o0o 
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O0000 


O000 
0000 
0000 
0000 
OOOO 


The following are work station control mode 
functions of the left control keys: 


Work Station 
Control Mode 


Key 

Help 

WS Ctrl 

Finish 
Finish 

ChgSc 


Function 


Brings up a Help 
panel. Press 
again to make 
the Help panel 
disappear. 


Puts you in work 
station control 
mode. Can be 
pressed in appli- 
cation and work 
station control 
modes. Press WS 
Ctrl again to go 
to application 
mode. 


Ends your acti- 
vity at one work 
station control 
mode level and 
moves you back 
to the previous 
level. 


Changes from 
defined screen 
profile to defined 
screen profile 

in numeric se- 
quence. Can be 
pressed in appli- 
cation and work 
station control 
modes. 
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Jump 


ErInp 


Print 


Copy 


Jumps from win- 
dow to window 
in alphabetic se- 
quence. Can be 
pressed in appli- 
cation and work 
station control 
modes. 


Deletes a pre- 
viously made 
recording. 


Prints to the 
IBM 3270 Per- 
sonal Computer- 
supported locally 
attached printer 
either the exact 
display screen or 
an enlarged win- 
dow. However, 
certain charac- 
ters may not 
print on the 
printer exactly as 
you see them in 
your window, or 
they may print as 
blanks; for exam- 
ple, the ‘‘¢’’ sign 
and some Pro- 
grammed Symbol 
set characters. 


Activates the 
copy function. 


Auto Activates the 
autokey function. 


Pause Pauses so you 
can insert varia- 
ble information 
into an autokey 
recording. Press 
again to resume 
autokey playing 
and recording 
after variable 
information is 
typed. 


Enlarge Makes the 
selected and 
subsequent win- 
dows as large as 
can be physically 
displayed on your 
display screen 
until toggled off. 
Can be pressed in 
application and 
work station con- 
trol modes. 
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Delete Window 


Quit 


Reset 


Deletes selected 
window. 


Cancels your cur- 
rent function. 
Perhaps you 
made a mistake 
when you 
changed the color 
of your window. 
Press Quit to 
return to the 
color of your 
window as it was 
before you began 
to change it. You 
are still at the 
same level but 
you cancel the 
action you were 
performing. 


Removes mes- 
sages from the 
message line/user 
prompt area. 


Work Station Control Mode Keys in 
the Typewriter and Numeric Keypad 
Area 


You can use all black engraved keys in both the 
Typewriter and Numeric Keypad areas. In addi- 
tion, in the Numeric Keypad area, you can use 
digits in normal and shift states. 


ChgSc Press and nor A Jenin tor thas tuncnon ODoooOooOoOoOoOoOno 
Jump | even ant rie tuncnion un lowereane Noocosoooo08 
BEREEEREEREBER COO O00 
BEBERESERRERes OOO 
EERE Ree O 


SRERERReeeeeee OOO 
wT 


apAApSPPAAAeAe 


oo 


OoO0o0o0 
a 
Dood 


pat oS 
NumLk SerLk Space 
[fen 
7 8 9 
4 6 
t > 

& 4 

+ 
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Work Station Control Mode Keys in 


the Program Function Key Area 


—————____ { 
ChgSc Press and hold ny {shift} for this function 
Jump $$ You get the function tn towercase. 


[ cxse \ Press and hold (Alt) tor this function. 


nonoooooooo00n8o 
Ooo0o00oo0000n00n0 
QOooooooo00o0o0000 
Ooooooooo000000 
DoOogooooooo0000o 


fort \froe \ foun \f vom \fome \from \fonm \fowm Vo \f \faner\f | 
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o000 
0000 
0000 
0000 
0o00 


The following are work station control mode 
functions of the program function keys: 


Key 
PF 1 (List) 


PF2 (Set Up) 


PF3 (Browse) 


Function 


Displays panel 
on the right side 
of your screen. 
When you press 
this key in work 
station control 
mode, it lists the 
screen profiles 
you defined 
(Screen Profiles 
0-9), and the win- 
dows you defined 
for each screen 
profile. When you 
press this key 
while in autokey, 
PF 1 lists autokey 
recordings. Press 
again to make 
List disappear. 


Activates the 
Set Up function. 
Press again to 
turn SetUp off 
and to return you 
to work station 
control mode. 


Activates the 
browse function. 
Press again to 
turn browse off 
and to return you 
to work station 
control mode. 
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PF4 (Play) 


PF8 (Color) 


PF9 (Hide) 


PF10 (Corner) 


PF11 (Move) 


Plays a recording 
during the auto- 
key function. 


Activates the 
color function 
during the SetUp 
function. 


Activates the 
hide function 
during the SetUp 
function. 


Activates the 
corner function 
during the SetUp 
function. 


Activates the 
move function 
during the SetUp 
function. 


PF 12 (Size) 


PF 13 (Source) 


PF 14 (Target) 


PF16 (Record) 


PF13-PF20 


Activates the size 
function during 
the SetUp 
function. 


Defines the 
source during the 
copy function. 


Defines the tar- 
get during the 
copy function. 


Records key- 
strokes during 
the autokey 
function. 


Colors you can 
change for the 
display screen 
background and 
the foreground 
and background 
of the host and 
notepad win- 
dows. These 


colors are: 

Red PF13 
Pink PF14 
Green PF15 
Yellow PF16 
Blue PF17 
Turquoise PF18 
White PF19 
Black PF20 
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PF21 (Base 
Color) 


PF22 (Screen 
Background) 


PF23 
(Foreground) 


Alt + PF23 
(AltCr) 


Sets the base 
color for a win- 
dow. See Chapter 
7 for further 
details. 


Allows you to 
change the 
color of the 
display screen 
background. 


Allows you to 
change the color 
of the window 
foreground. 


Allows you to 
select which type 
of cursor appears 
on your screen. 
Initially you get 
the normal, or 
default, cursor. It 
is an underscore. 
Then, as the cur- 
sor rotates in a 
‘round robin’’ 
fashion each time 
you press Alt + 
PF 23, you get: 


® Blinking 
underscore. 


@ Reversal of 
the color of 
the character 
and its back- 
ground. The 
cursor looks 
like a small 
box. 


@ Reversal of 
the color of 
the character 
and its back- 
ground and 
simultaneous 
blinking. The 
cursor looks 
like a small, 
blinking box. 


PF24 Allows you to 

(Background) change the color 
of the window 
background. 
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Keeping Track of Active 
Functions 


We have told you that, in application mode, you 
need to keep track of whether you are in a host, 
personal computer, or notepad session because 
certain functions are active only during certain 
sessions. You keep track of your session by 
noting the operator information area and the 
active window. It has a double line border and a 
cursor. 


In work station control mode, you must also 
determine which functions are active if you want 
to use the SetUp, browse, autokey, and copy 
functions. You do this by referring to the opera- 
tor information area, checking the selected 
(double-bordered) window, and using the Help 
panel. 


Levels of Functions 


A useful way to understand active functions in 
SetUp, browse, autokey, and copy is to think of 
levels of functions. Perhaps you’ll want to look 
at and follow the chart on the next page. It isa 
graphic representation of the information that 
follows. 


Level 1 


Work station control is a Level 1 function. This 
means that you must first press the WSCtr1 key 
to perform autokey, SetUp, browse, or copy. 


Level 2 


Autokey, SetUp, browse, and copy are Level 2 
functions. This means you must be in these func- 
tions to perform specific tasks. 
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Level 3 


@ Level 3 functions of autokey are: 
— Record 
— Play 
— Erase 
@ Level 3 functions of SetUp are: 
— Color 
— Hide 
— Corner 
— Move 
— Size 
Browse does not have any Level 3 functions. 
Level 3 functions of copy are: 
— Source 
— Target 


For example, to move a window in your screen 
profile: 


1. Press WS Ctrl (Level 1 function) 
2. Press PF2 (SetUp - Level 2 function) 
3. Press PF11 (Move - Level 3 function) 


These three levels of functions are illustrated in 
the following chart. 


Working in Work Station Control Mode 6-19 


Work Station 
Control 


LEVEL 1 
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Autokey 


Setup PF2 


Browse PF3 


Copy 


LEVEL 2 


Play PF4 


Record PF 16 


Erlnp 


Color PF8 


Hide PF9 


Corner PF10 


Move PF 11 


Size PF12 


Source PF13 


Target PF 14 


LEVEL 3 


Often you may want to move between levels. 
Below are two ways to do this: 


@® You can move from any level back to appli- 
cation mode by pressing the WS Ctrl key. 


@ You can move one level back, from Level 3 
to Level 2 for example, by pressing the 
Finish key. 


Selecting a Screen Profile 


A screen profile must have been previously 
defined with at least one window. To perform 
Level 2 functions, you must bring a defined 
screen profile up to your display screen. You can 
do this in either of two ways: 


@ Press the number of the defined screen pro- 
file (0 through 9). 


@ Press ChgSc. 
The operator information area will give the 
number of the selected screen profile. The follow- 


ing illustration shows a change between screen 
profiles. 
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Selecting a Screen Profile 


1. Press WS Ctrl 


|| pE--NOTEPAD2— , 


WINDOW=C SCREEN=4 


2. Press 2 (the screen profile number) 


--HOST 


tam 


WSCTRL a WINDOW=A SCREEN=2 : 
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Selecting a Window 


To perform Level 2 functions, you must select 
your window. You can do this in either of two 
ways: 


@ Press the short name of the selected window 
(A through Z). 


@ Press Jump. 


Each time you press the short name of the 
window, it will become double-bordered. Notice 
that if a selected window was previously overlaid 
with another window, the selected window 
‘‘pops’”’ to the top. In either case, the window is 
now selected, and the operator information area 
will give its short name. Neither the number nor 
the arrangement of the windows changes when 
you select a window. However, some windows 
may be covered by the selected window. 
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Selecting a Window 
1. Press WS Crtl 


WINDOW=B SCREEN=4 
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2. Press A (short name of window) 


Window A is now 
double-bordered 


The selected window 
overlays Window B 


/. 
6 


WSCTRL * WINDOW=A SCREEN=4 


OIA shows the window change 
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Press F (the short name of the window) 


WINDOW=F SCREEN=4 


Operator information area 
shows the window change 


Window F is now double-bordered 
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Other Work Station Control 
Mode Functions 


When you are in work station control mode, you 
can also add and delete windows, use Help and 
List, print the contents of what is on the display 
screen or what is in an enlarged window. Add 
and delete functions are discussed in Chapter 7. 
Using Help and List are discussed in Chapter 2. 
Printing is discussed in Chapter 12. 
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Introduction 


This chapter is for people who want to set up 
their own screen profiles and change windows. It 
specifically illustrates what you must do to: 

@ Define Screen Profiles 1 through 9 

Get in and out of SetUp 

Add a window 

Delete a window 

Size a window 

Move a window 


Corner a window 


Hide a window 


Change colors in a screen profile 


Remember that the Help and List functions are 
important aids during SetUp. Help will give 
your active functions; List will provide a listing 
of screen profiles and windows. 


To permanently save and restore the specific 


ways you choose to arrange your screen profiles 
and windows, see Chapter 11. 
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Add 


Background 
color 


Base color 


Corner 


Defined screen 
profile 


Delete 


Foreground 
color 


Work station control 
mode function that allows 
you to add a window 
defined on Screen Profile 
0 to the screen profile 

(1 through 9) you are 
presently defining. 


Color of the window 
background. 


Provides the following 
four colors to standard 
parts of a monochrome 
data set for host and 
notepad sessions: 


@® Green 
@® White 
@ Red 

@ Blue 


SetUp function that 
moves a window clockwise 
to each of the four corners 
of the display screen. 


Screen profile that 
contains one or more 
windows. 


Work station control 
mode function that 
removes a window from a 
screen profile. 


Color of both characters 
and border within a 
window. 


Hide 


Move 


Screen 
background 
color 


Size 


Set Up function that 
temporarily removes a 
window from a screen 
profile. 


SetUp function that 
allows you to move a win- 
dow either horizontally or 
vertically on the screen. 


Color of the display screen 
in the application window 
area that is not covered by 
windows. 


SetUp function that 
allows you to change the 
vertical and horizontal 
boundaries of a window. 
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Defining Screen Profiles 1 
through 9 
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You now know that Screen Profile 0 contains all 
the windows, up to 7, configured for your partic- 
ular needs. You can configure each of the Screen 
Profiles 1 through 9 differently, but remember 
that you can only use the existing windows on 
Screen Profile 0. The first step you must do is to 
define a screen profile. 


To define a screen profile: 
1. Press WS Ctrl. 


2. Type the number of the screen profile, from 
1 through 9, you want to define. 


You can now use the rest of the functions in this 
chapter for whatever screen profile you have 
defined. 


Getting In and Out of SetUp 


Now that you have defined a screen profile, you 
go into SetUp to do things like add, delete, size, 
move, corner, and hide windows, and change 
their colors. 

To get into Set Up: 

1. Press WS Ctrl. 

2. Press PF2 (SetUp key). 

To get out of SetUp: 


1. Press SetUp to put you in work station con- 
trol mode. 


2. Press the WS Ctrl key to put you in applica- 
tion mode. 


You can check your operator information area to 
make sure you are in SetUp. Your operator infor- 
mation area should look like this: 


WSCRTL SETUP WINDOW = G SCREEN =3 
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Adding a Window 
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Though you do not have to go through Level 2 
SetUp to add a window, you will find it easier to 
use this function while you are in SetUp. If you 
add a window at another time, you may get con- 
fused because you will be adding a window from 
Screen Profile 0 that has not been changed to 
meet your current needs. 


You can add any window from Screen Profile 0 
to Screen Profiles 1 through 9. Once you have 
added a window to your screen, you can change 
its size, shape, position, and color. 

To add a window to Screen Profiles 1 through 9: 


1. Press WS Ctrl. 


2. Press the number of the desired screen pro- 


file (1 through 9), or press ChgSc. If you 
press ChgSc, the screen profile must have 
been previously defined with at least one 
window. 


3. Press the short name of the window you are 
adding (A through Z). 


4. Press different short names to continue 
adding windows. 


Adding A Window 


1. Press WS Ctrl 


WINDOW=C SCREEN=4 


2. Press F 


= 
— ee 


WINDOW=F SCREEN=4 
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3. Press E 


The last window added becomes selected 


WSCTRL WINDOW=E SCREENS4 


The window added has the same location and 
size as on Screen Profile 0. 


Deleting a Window 


Though you do not have to go through Level 2 
Set Up to delete a window, you will find it easier 
to use this function while you are in SetUp. If 
you delete a window at another time, you may 
get confused because when you add the deleted 
window back to your screen profile it will reap- 
pear as a Screen Profile 0 window. 


If you delete all windows on a defined screen pro- 
file, you will delete that defined screen profile 
also. You can very simply define that screen pro- 
file again by following the steps under ‘Defining 
Screen Profiles 1 through 9’’. When you do this, 
a blank screen profile appears again. 


Deleting a window removes it from the screen 
profile. If you want to remove a window tempo- 
rarily, you should use the hide function instead 
of the delete function. You will learn about hide 
later in this chapter. To delete a window: 


1. Press WS Ctrl. 


2. Press the number of the desired screen pro- 
file (1 through 9), or press ChgSc. If you 
press ChgSc, the screen profile must have 
been previously defined with at least one 
window. 


3. Press the short name of the window you are 
deleting (A through Z). 


4. Press the Delete Window key. This key is 
referred to by Del (_] on the Help panel. 


Using SetUp 7-11 


7-12 


Deleting a Window 


1. Press WS Ctrl 


2. Select the window by typing its short name 
or by pressing Jump 


WINDOW=C SCREEN=4 


3. Press Delete Window 


WINDOW=E SCREEN=4 


Sizing a Window 


Sizing a window means you change its dimen- 
sions by using the black cursor movement keys 
to move the right border either to the left or to 
the right, and/or the bottom border either up or 
down. The top and left borders do not move with 
this function. This allows you to display more or 
less of the information behind that window. You 
can also move the borders of a selected window 
to overlay another window. And you can change 
the size of windows in any screen profile, but 
remember that the window must be selected. To 
size a window: 


1. Press WS Ctrl. 
2. Press PF2 (SetUp key). 
3. Press PF12 (Size key). 


4. Use the black cursor movement keys to 
move the window borders. 


5. Use Jump or the letter name of the window 
to size another window. 


6. Press Finish, SetUp, or WS Ctrl. 


Now that you have sized a window, you can 
move it anywhere on your display screen. 


The following illustration shows how to size a 
window. 
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Sizing a Window 


1. Press WS Ctrl 
2. Press PF2 (SetUp key) 
3. Press PF12 (Size key) 


WSCTRL SETUP SIZE z WINDOW=A SCREEN=4 


4. Use the black cursor movement keys to 
move the window borders. 


WSCTRL SETUP SIZE WINDOW=A SCREEN=4 


Moving a Window 


Moving a window means changing the window’s 
location either horizontally or vertically on the 
screen. You must select the window to move it. 
You can move a window to overlay another win- 
dow. You can also stack windows on top of each 
other. To move a window: 


1. Press WS Ctrl. 


2. Select the window you want to move by 
pressing Jump or the short name of the 
window. 


3. Press PF2 (SetUp key). 

4. Press PF11 (Move key). 

5. Use the black cursor movement keys to 
move the window. You can also use the 
Home Key to move the window to the upper 
left corner of your screen. 

6. Press Jump or the short name of the win- 
dow to move another window in the same 
screen profile. 


7. Press Finish, SetUp, or WS Ctrl. 


The following illustration shows the moving of 
windows. 
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Moving a Window 


1. Press WS Ctrl 
2. Press PF2 (SetUp key) 
3. Press PF11 (Move key) 


WSCTRL SETUP HOVE e WINDOW=F SCREEN=4 


4. Use the black cursor movement keys to 
move the window 


WSCTRL SETUP MOVE us WINDOW=F SCREEN=4 


Cornering a Window 


Cornering is a fast way of moving sized windows 
clockwise to each of the four corners of your dis- 
play screen. This allows you to see information 
previously covered. It moves first to the upper 
left corner of the screen. A cornered window can 
partially overlay or totally cover another win- 
dow. Note that you may not always see all four 
borders of the window you are cornering. 


You must be in SetUp and your window 
selected before you perform this task. To corner 
a window: 


1. Press WS Ctrl. 

2. Select the window you want to corner by 
pressing Jump or the short name of the 
window. 


3. Press PF2 (SetUp key). 


4. Press PF10 (Corner key). The PF10 key 
moves the window to a different corner each 
time it is pressed. 


5. Press Finish, SetUp, or WS Ctrl. 


The following illustration shows the cornering of 
windows. 
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Cornering a Window 


l. 
2. 
3. 


4. 


Press WS Ctrl 
Press PF2 (SetUp key) 
Press PF 10 (Corner key) 


SCTRL SETUP ~ WINDOW=F SCREEN=4 


Press PF 10 again 


WSCTRE SETUP WINDOW:F. SCREEN=4 


Hiding a Window 


Hiding a window means removing it temporarily 
from a display screen. For example, if you are 
working within window A and using information 
from window B, you do not need to have window 
A present all the time. You can ‘“‘hide’’ window 
A temporarily instead of deleting it. Hide means 
the window will return in the same size and posi- 
tion when you un-hide it. Delete means that you 
remove the window from the screen profile. You 
can add the window, but then the window re- 
turns to its default size - whatever is on Screen 
Profile 0. 


You must select a window to hide it. When 

the selected window is hidden, the previously 
selected window becomes selected again. For ex- 
ample, window B was previously selected. You 
decide to hide window A. You select window A 
and hide it. Then, window B becomes selected 
again. Now you decide to un-hide window A. 
Thus, window A is again selected. 


You can never hide all your windows. One win- 
dow will always appear. To hide a window: 


1. Press WS Ctrl. 

2. Select the window you want to hide by 
pressing Jump or the short name of the 
window. 

3. Press PF2 (SetUp key). 

4. Press PF9 (Hide key). 


5. Press Finish, SetUp, or WS Ctrl. 
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To un-hide a window: 
1. Press WS Ctrl. 
2. Press the short name of the hidden window. 


Note: You cannot get to a hidden window 
by pressing Jump. 


3. Press Finish, SetUp, or WS Ctrl. 


The following illustration shows this process. 
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Hiding a Window 


1. Press WS Ctrl 
2. Press PF2 (SetUp key) 


WSCTRL SETUP & WINDOW=F SCREEN=4 


3. Press PF9 (Hide key) 


WSCTRL SETUP * WINDOW=A SCREEN=4 
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Changing Color 


If you have a color display, you can: 
@ Change the display screen background 


@ Set the host and notepad windows for base 
color 


@ Change the colors of the foreground and 
background of the host and notepad 
windows. 


Before you begin changing colors, it is important 
to remember these rules: 


1. The window must be selected before you 
can change its color. Press Jump or type 
the short name (A through Z) to select a 
window. 


2. You must set the colors of each window 
individually. 


3. You cannot change the colors of the per- 
sonal computer session. 


4. You can use the same color for the back- 
ground and foreground, but it will be illegi- 
ble. This action produces a warning 
message. 


5. You can set the display screen background 
color for each screen profile; otherwise, you 
get the black default color. You must be 
able to see the display screen background 
between the windows in order to notice a 
change in the color. 
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Seven-color data in a host or notepad win- 
dow can override the color setting you 
selected. If your host computer is capable of 
sending extended attribute buffer (EAB) 
color data and the host session is custom- 
ized to receive EAB color data, the EAB 
color data may override the colors you just 
chose. Your chosen colors appear when the 
application using the EAB color data 
completes. 


If you are typing in technicolor in a notepad 
window (see Chapter 5), you can continue 
until you physically clear the window by 
pressing Clear. (Remember that if you press 
Clear, you lose data in that notepad window. 
If you want to save that data, use the save 
command.) 


If your window background is white, you 
will not be able to see the white default cur- 
sor against the window background color. 
We suggest you use the alternate cursor 
(AltCr) functions to see your cursor. See 
Chapter 6 for more information. 


You can change the display screen back- 
ground and the foreground and background 
of the host and notepad window in eight 
different colors. The colors and their key- 
strokes are: 


@ Red Alt + PF13 
@ Pink Alt + PF14 
@ Green Alt + PF15 
@® Yellow Alt + PF16 
@ Blue Alt + PF17 
@® Turquoise Alt + PF18 
@ White Alt + PF19 
@ Black Alt + PF20 
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9. When you are using your IBM 3270 Per- 
sonal Computer only as a personal computer 
or as a 3270 terminal, follow the rules for 
that particular unit. 


For further information, see JBM 3270 Informa- 
tion Display System: Color and Programmed 
Symbols and IBM 3270 Information Display 
System 8274 Control Unit Description and Pro- 
grammer’s Guide. 


Setting the Base Colors for a Window 


Base color provides the following four colors to 
standard parts of a monochrome data set for 
host and notepad sessions: 


@ Green 
@ White 
@ Red 

@ Blue 


You set the base colors in work station control 
mode. These four colors, the base colors, are the 
default colors. Once you have set the base colors 
for a window, the characters in your window are 
displayed with these four colors. Certain host 
applications require your host session to use 
base colors to take full advantage of the func- 
tions. Perhaps you want to change the fore- 
ground and background colors to something 
different than the default colors you get here. 
You can do that, and those procedures are cov- 
ered later in this chapter. If you ever want to go 
back to the base colors, press PF 21. 

To make sure your window is selected: 


1. Press WS Ctrl. 

2. Press Jump or the short name of the win- 
dow to select the window whose color you 
want to change. 

3. Press PF2 (SetUp key). 

4. Press PF8 (Color key). 

5. Press PF21 (Base Color key). 


Your screen will look similar to this: 
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Setting the Base Colors for a Window 


1. Press WS Ctrl 
2. Press PF2 (SetUp key) 
3. Press PF8 (Color key) 


B--HOST2 
=-NOTEPADZ 


a a | 


WSCTRL- SETUP COLOR WINDOW=C SCREEN=1 


4. Press PF21 (Base Color key) 


WSCTRL SETUP COLOR WINDOW=C SCREEN: 1 


Changing the Display Screen 
Background 


You may want to change the color of the display 
screen background. To do this: 


1. Press WS Ctrl. 

2. Press PF2 (SetUp key). 

3. Press PF8 (Color key). 

4. Press PF22 (Screen Background key). 

5. Press Alt + one of PF13-PF20 (colors). 
You must be able to see the display screen back- 
ground between the windows in order to notice a 


change in the color. 


Here are some illustrations of the color changes 
you can make: 
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Changing the Display Screen Background 
1. Press WS Ctrl 


2. Press PF2 (SetUp key) 
3. Press PF8 (Color key) 


B--HOST2 


--NOTEPAD2 


WSCTRL SETUP COLOR WINDOW=C SCREEN=1 


4. Press PF22 (Screen Background) 
5. Press Alt + PF19 (White) 


FO 
~-NOTEPAD 


Select the color setting desired by using the color coded keys. 
WSCTRL SETUP COLOR SCBK _ WINDOW=E SCREEN=1 
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Changing the Foreground and 
Background of a Window 


You may want to change the foreground color 
and the background color of your selected win- 
dow. Notice that text and borders take on the 
foreground color. The following procedure and 
illustration show how to do this. 


1. Press WS Ctrl. 


2. Press Jump or the letter name of the win- 
dow to select the window whose color you 
want to change. 


3. Press PF2 (SetUp key). 

4. Press PF8 (Color key). 

5. Press PF23 (Foreground key) to change the 
foreground color or press PF24 (Background 


key) to change the background color. 


6. In either case, you choose your color by 
pressing Alt + one of PF13-PF20 (colors). 


If you choose to change both foreground 
and background colors, simply go to step 5 
and press the other PF key, either PF 23 or 
PF24, and continue with steps 6 and 7. 


7. Press SetUp to return to WSCTRL. 
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Changing the Foreground and Background of a 
Window 


1. Press WS Ctrl 
2. Press PF2 (SetUp key) 
3. Press PF8 (Color key) 


--NOTEPAD2 


WSCTRI SETUP COLOR a WINDOW=C SCREEN=1 


4. Press PF24 (Background key) 
5. Press Alt + PF18 (Turquoise) 


~-NOTEPADZ 


Select the color setting desired by using the color coded keys. 
WSCTRL SETUP COLOR BKCND WINDOW=C SCREEN=1 
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6. Press PF23 (Foreground key) 
7. Press Alt + PF13 (Red) 


B--HOST2 


Select the color setting desired by using the color coded keys. 
WSCTRL SETUP COLOR FRGND _ WINDOW=C SCREEN=1 
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Notes: 
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Introduction 


This chapter is for you who want to browse win- 
dows without changing the contents. You must 
be in work station control mode to browse your 
window. Browse is a level 2 function of the WS 
Ctrl key. 


Terms You Need to Know 


Browse A work station control mode 
function that allows you to 
move the data contained in 
the presentation space verti- 
cally or horizontally within a 
window. 


Browsing a Window 


When you browse a window, you are looking at 
the presentation space behind the window. The 
window does not move. The information in the 
presentation space moves up, down, to the left, 
and to the right, depending on how you use the 
black cursor movement keys in the personal 
computer key area. 


Browsing is like window-shopping when the 
stores are closed. You can look at all the articles 
displayed behind the window, your window into 
the store, but you cannot buy any of these 
articles until the store is open. Thus, you are still 
in work station control mode. You can enter data 
when you switch to application mode. 
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If the cursor is not visible in the window you 
just browsed when you entered application 
mode, the contents behind the window will move 
so that the cursor is visible again. 


To browse a window: 
1. Press WS Ctrl. 


2. Press Jump or the short name of the win- 
dow to select the window you want to 
browse. 


3. Press PF3 (Browse key). 


4. Use the black cursor movement keys to 
move the information. Remember that you 
are moving data up, down, to the left, or to 
the right behind the window. This is because 
the direction that your black Cursor Move- 
ment keys points to is the direction your in- 
formation moves. Want to move the 
information left? Use €-. Want to move 
the information right? Use —p. 


5. Press Jump or the short name of another 
window if you want to browse another 
window. 


6. To stop browsing, press PF3 (Browse) or 
WS Ctrl. 


Browsing a Personal Computer 
Graphics Window 


You can browse a personal computer window pel 
by pel while you have a graphics application run- 
ning in that active personal computer window. 
This means you can browse your window picture 
element (pel) by picture element instead of char- 
acter by character by using the black cursor 
movement keys. To do this: 


1. 


2 


Press WS Ctrl. 


Press Jump or the short name of the win- 
dow to select the window you want to 
browse. 


Press PF3 (Browse key). 
At this point, you can browse the data in 


the window character by character. Your 
operator information area looks like this: 


| BROWSE CHAR | 


6. 


Now press Alt + PF3 to browse pel by pel. 


Use the black cursor movement keys to 
browse the information in the window. Your 
operator information area looks like this: 


BROWSE PEL 


To leave browsing pel by pel, press 
Alt + PF3 again. 
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Introduction 


This chapter is for anyone who wants to copy 
data from one area to another within the same 
window, or from one window to another on the 
same screen profile or on different screen 
profiles. 


Suppose you have data in a host window or 
notepad that you would like to copy to another 
window or copy to another area of the same win- 
dow. Or suppose you have data in the personal 
computer window that you would like to have in 
another window. Copy provides you with the 
ability to do this. 


Terms You Need to Know 


Copy The Level 2 work station con- 
trol mode function that allows 
you to mark source lines in one 
window and move them to a 
target location either within 
the same window or to another 
window. Exiting Copy by 
using the Finish or WS Ctrl 
keys before completing the 
copy operation causes all copy 
information to be lost. 


Source A Level 3 function within the 
copy in which the lines are 
marked with the cursor select 
(CrSel) key as those to be 
copied either within the same 
window or to another window. 
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Target A Level 3 function within the 


Notes 
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copy in which the upper left 
corner of a location is marked 
with the cursor select (CrSel) 
key to indicate the place to 
which marked source lines are 
to be moved. 


You can copy into any window except a per- 
sonal computer window. Also, you cannot 
copy from one area to another within the 
personal computer window. 


To use Copy, you must use your cursor to 
define your source and target areas. You can 
copy a word, a line, or a block of data. 


The block must be as wide as the longest 
line of the source data you want to copy. 
If it is not, the data will be cut off when 
copied. 


To copy more than is visible in a window, 
automatic data scrolling occurs as the cur- 
sor is moved to identify the corners of the 
block of data to be copied. 


Non-display fields and protected fields are 
copied as blanks. 


You cannot copy into a non-display or pro- 
tected field. 


If you copy into a target area that is totally 
protected, you will get a warning message, 
telling you that nothing is being copied. 


If the personal computer session is in graph- 
ics mode, you cannot copy that data into 
another window. 


If you copy from a host session that sup- 
ports Programmable Symbols to a notepad 
or a host session that does not support Pro- 
grammable Symbols, all Programmable 
Symbol data will be copied as blanks and all 
base data will be copied as-is. 


If you don’t want the copied data to overlay 
existing data in the target area, you must 
make room for the data before copying. 


If the Help panel or message/prompt line 
appears on the screen during the Source or 
Target definition, the cursor will not appear 
on the screen when moved ‘“‘under’”’ either of 
these windows. To see the cursor, either re- 
move Help from the screen, or size or move 
the selected window so it will not be covered 
by the Help panel or message/prompt line. 


If an error message appears and overlays a 
prompt, press Reset to remove the error 
message and redisplay the prompt. 


When you leave Copy by pressing WS Ctrl, 
your source and target areas will be 
removed. 


In this chapter, we discuss: 


Copying data within a window and to 
another window 


— Defining the source area 


— Defining the target area 
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Copying Data 


Defining the Source Area 
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When defining the source area, you will use the 
black cursor movement keys in the Right Con- 
trol key area. 


1. 


Press WS Ctrl to get into work station con- 
trol mode. 


Select the window you will be copying 
from by typing the window short name or 
pressing Jump until the window is 
double-bordered. 


Press Copy. The following prompt appears: 


Define source or target area. 


You can define either the source or target 
area first; here, we’ll define the source area 
first. Select the window you are copying 
from. 


Press PF 13 to define the source area. The 
following prompt appears: 


Position cursor and use CrSel key to define 
first corner. 


Use the black cursor movement keys to 
position the cursor at the beginning of the 
data you want to copy and press CrSel. 


Position cursor and use CrSel key to define first corner. 
WSCTRL COPY SOURC WINDOW=C SCREEN=1 o+n 


The following prompt appears: 


Position cursor and use CrSel key to define 
second corner. 


Copying 9-7 


6. Use the black cursor movement keys to po- 
sition the cursor under the last character of 
the data you want to copy. Make sure you 
allow for the longest line by positioning the 
cursor so the data you want to copy will be 
within the source area. 


Bf Mow is the tine for 
all good women fo come 
to the aid of their 
party. 


Position curser and use CrSel key to define second corner. 
WSCTRL COPY SOURC VINDOW-C SCREEN=1 ong 


7. Press CrSel. The source area will be under- 
scored and marked with corner marks. What 
is not underscored will not be copied. If 
some of the data you want to copy is not 
underscored, or if you are not satisfied with 
the source area you have defined, you must 
go back to step 4 and redefine the entire 
source area. If the source area is within a 
personal computer window, no underscoring 
appears but the source will be marked with 
corner marks. 


8. If you are satisfied with the source area you 
have defined, go on to define the target area. 


Defining the Target Area 


1. Select the target window by using the Jump 
key or by entering the short name of the 
window. If the window is on a different 
screen, first activate the screen and then 
select the window. 


2. Press PF 14 to define the target. 
The following prompt appears: 


Position cursor and use CrSel key to define 
first corner. 


3. Move the cursor to the upper left corner of 
the area to which you want the source data 
to be copied. 


Pasition cersor and use CrSel Key to define first corner. 
UStTRL COPY TARGT WINDOW-C SCREEN 1 og 
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Press CrSel. An area the same size as the 
source area appears in reverse video. Any 
data already in the target area will be 
covered over when the copy is done. 


The following prompt appears: 


Source and Target areas are defined. Use 
the Enter key to copy. 


Note: A warning message will appear if the 
source and target areas overlap. 


If you are not satisfied with the target area 
you have defined, go back to step 1 and re- 
define the target area. 


If you are satisfied with the target area you 
have defined, go on to copy the data. 


Copying the Data 


1. Press Enter to copy the data. The data in 
the source area appears in the target area. 


2. The following prompt appears: 


Copy complete. Define Source or Target or 
press Finish. 


a. If you want to copy the same source 
data to different targets, simply rede- 
fine the target area. 


b. To end Copy, press Finish. This takes 
you out of Copy. 


Note: If the defined target area is smaller than 
the defined source area, the data will be cut off 
when copied. 


The sequence for copying within a window is 
illustrated on the following pages. 
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1. Press WS Ctrl 
2. Press Copy 
3. Press Help 


D--NOTEPADZ eeenenxe COPY « 
VALID KEYS: 


PF13 = Def Source 
PF14 Def Target | 
Enter Do the Copy 


Enlarge 
Next Screen 
Named Sern 
Next O 
Named 0 
List 0 


Remove Help 
Finish 
Exit WSCTRL 
Cancel 


tout wo 


Print Sern 


Define source or target area 


WSCTRL COPY * WINDOW=C SCREEN=1 


4. Press PF13 (Source key) 
5. Define source area 


wune COPY TARGET “ae 


Marker Up | 
Marker Down 
Marker Rght 
Marker Left 


Mark Target 


Enlarge 
Next Screen| 
Named Sern 
Next 0 
Hamed 0 


Remove Help 
Finish 
Exit WSCTRL 
Cancel 


= Print Sere 


e firecd 


WINDOM-C SCREEM 


9-12 


6. Press PF14 (Target key) 
7. Define target area using the black cursor 
movement keys 


D--NOTEPADZ ween COPY xexnxxx| 
VALID KEYS: ite 
PF13 = Def Source | 
PF14. = Def Target 
Enter = Do the Copy| 
oe] Enlarge 
ChgSc Next Screen 

Named Scrn 
Next O 
Named O 
List Oo 
Remove Help| 
ini Finish 
Exit WSCTRL 
i Cancel 
i Print Scrn 


Oc eee Te 


ee ee 


Source and Target areas are defined. Use the Enter key to 
WSCTRL COPY " WINDOW=C SCREEN=1 


8. Press Enter 


D- -NOTEPADZ wre HSCTRIL sicrseen 
VALID KEYS: 


futokey 
Setup 
Browse 
Copy Data 


nonomwou 


| 
| 
Enlarge 
Next_Screen 
Named Scrn | 
= Next O 
= Named O 
= Delete 0 
= List O 


= Remove Help 
= Exit WSCTRL 


= Print Sern 


= Cancel Prat} 
| 


WINDOW=C SCREEN=1 
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Chapter 10. Autokeying 
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Introduction 


This chapter is for anyone who needs to use the 
autokey function. With this function you can 
record frequently used groups of keystrokes. 
Since you can play these keystroke records at a 
later time, you can reduce keystroking time. 
Also, you can pause and enter variable or 
changeable information within the recording. 


When you create a recording, it is saved only for 
that particular session. You must use the save 
and restore commands to save and restore a 
recording permanently. See Chapter 11 for Save 
and Restore commands. 


This chapter describes: 


Terms you need to know 
List 

Record 

Pause 

Play 

Erase 

Finish 

Quit. 


Terms You Need to Know 


Recording name A unique name that can 
consist of up to eight 
alphanumeric charac- 
ters. It can be fewer 
than eight characters. It 
cannot contain blanks. 


Variable A quantity that can 


assume any of a given 
set of values. 
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List 
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You can use List in work station control mode 
when you are using autokey: 


iL 


2. 


Press WS Ctrl 
Press Auto 
Press PF1 (List). 


List appears on your display screen with 
this information: 


a. Names of your autokey records 
b. Lengths of those records 


c. Amount of space remaining for you to 
continue to record 


If you have more record names than are 
shown in List, you can scroll List. Press the 
up or down black cursor movement keys. If 
you press the Home Key, the beginning of 
List appears on your display screen. 


6. You must remove List from your display 
screen before you use autokey. To do this, 
press PF 1, which is a toggle key. 


CPAs wee AUTOKEY LIST «xx| 
RECORDINGS SIZE 


Space Left: 2028 
VALID KEYS: 


UP-> = Scroll List 
DOWN-> = Scroll List 


Remove List 
= Exit WSCTRI 


Print Scrn 
= Cancel Prot 
WS615 Warning: List must be removed to continue most WS Ctrl work 
WSCTRL AUTO WINDOW=C SCREEN=1 
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Let’s Begin 
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These are the keys you can use for autokeying 
in addition to the List key described above. It 
depends on what function you want to perform. 
Help is available unless List appears on the dis- 
play screen. 


You are in work station control mode: 


Ctrt 


He 
” 


This is the Auto key: 


Copy 


Auto 


You can begin to record keystrokes as a record 
with a given name: 


You can play a record: 


BE 
mn 
a 


You can delete a record previously made by 
pressing ErInp: 


Erase 
EOF 


You can pause the recording to add variable 
information by pressing Pause: 


You can save the recorded keystrokes for this 
particular session. 


You can quit or cancel recording keystrokes or 
playing keystrokes during the play operation. 
Keystrokes entered are not saved. 


There are a few important points to know. First, 
you cannot record any key pressed while you are 
in work station control mode. 


Second, you cannot record these keys: 


® WS Ctrl 


oe °®@ 
oe) 
fo 2 
i ae) 
NM 
(o) 


@ 
ty 
c 
3 
i 
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Third, you can record an Initial Program Load 
(IPL) sequence (Alt + Ctrl + Del) only in a per- 
sonal computer session if you do not have either 
of these commands in your autoexec.bat file: 


indrstr autokey 
or 
indrstr 


Fourth, a recording is ‘‘attached”’ to the session 
in which it started. You cannot change sessions 
and expect the recording to continue in the 
newly selected session. 


Getting Ready to Record 
Keystrokes 
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Perhaps you want to record the first sentence for 
a form letter and you want the date to be varia- 
ble information. For example, 


Thank you for your letter of January 3. We are 
happy you approve our new line of sweaters. 


This way you do not have to type the entire sen- 
tence each time. You can record the sentence, 
and every time you play the recording you can 
change the date. 


To use autokey: 


1. 


Select the window to which you want to 
record by typing the window short name or 
by pressing Jump. 


Press WS Ctrl. 
Press Auto. 


From now on, you are prompted for informa- 
tion. The first prompt says: 


Press Play(PF4), Record(PF16), or ErInp 
key 


This means that you need to choose which 
aspect of autokeying you want to use: 


a. Are you playing previously recorded 
information? 

b. Are you making a new record? 

c. Are you erasing a record you no longer 
need? 


In this example, you are going to make a 
new record. 


Press Record 


The operator information area shows that a 
record name is needed. 
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How to Choose a Recording 


Name 
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What are the guidelines for naming a recording? 


ds 


A recording name can consist of up to eight 
alphanumeric characters. It can be fewer 
than eight characters. Helpful hint: To re- 
duce keystroking, you can make the name 
unique at the beginning of the recording 
name instead of at the end. For example, 
you may need recording names to identify 
memos to three persons: Julie, Kathy, and 
Marsha. You could name your recordings 
memojul, memokath, memomars. Then you 
have to enter those keystrokes every time 
you want to use your recording. To reduce 
keystroking, you could use these recording 
names: jmem, kmem, mmem. Thus, you 
need only a sufficient number of characters 
to make the name distinguishable from all 
other names to make a recording. It may be 
one character if no other name begins with 
that character. Or it may be all eight charac- 
ters if the first seven characters are also 
used in another name. These few characters 
are all you need to identify a recording. 


It cannot contain blanks. 


Two recordings cannot have the same name. 


Recording Keystrokes 


You are now ready to record keystrokes. 


1, 


You are prompted for a record name: 


Enter a unique name for the recording about 
to be made 


Choose a name that is not already in use. 
Consider using descriptive names so you can 
recognize their contents by their names. 


You can correct any typing errors and make 
changes by retyping the recording name, 
but you cannot insert or delete characters 
while in the operator information area. 


. Type the recording name. In this example, 


let’s use letter for the recording name. 
letter 


As soon as you type the first character of 
the recording name in the operator informa- 
tion area, the following prompt appears: 


Press the Enter key when the name is 
completed 


Press Enter. 


If the recording name is valid, the selected 
window becomes active and a record indi- 
cator (R) appears in the host and notepad 
operator information areas. 


a. If you are recording in a personal com- 
puter session and you want to see the 
record indicator (R), press Ctrl + WS 
Ctrl to toggle on the personal computer 
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session operator information area. If 
you do this, be aware that you will be 
recording this keystroking sequence 
also. 


b. When you play a recording, the opera- 
tor information area appears because 
you have recorded that sequence. You 
can toggle off the operator information 
area at the end of the recording. 


c. You have now left work station control 
mode and the cursor is in the active 
window. 


d. If you toggled on the personal com- 
puter session operator information area, 
you have already begun recording key- 
strokes and can continue to do so. 


e. If you did not toggle on the operator 
information area, you are now ready to 
begin recording keystrokes. 


f. No other recording session can begin 
until you end this one. 


If, by chance, the recording name you 
entered is identical with one already used, a 
message appears: 


WS004 Duplicate name entered: Choose a 
unique name 


In this case, change the recording name and 


press Enter. When you press Enter, your 
cursor moves from the operator information 
area to the active window. 


. Type the information you want to record, 


for example: 


Thank you for your letter of 


8. 


10. 


bs 


Press Pause. The Pause indicator (P) 
appears in the operator information area. 


This pause allows you to stop the recording 
process so that you can insert the variable 
information; in this case, it is the date when 
you replay the recording. During the pause, 
you may type in the date, but it will not be 
recorded. 


When typing in a host window, you can 
press a key, such as Enter or PAI, that 
causes you to communicate with the host 
system. Whenever this occurs, an automatic 
pause is inserted into the recording without 
your having to press the Pause key. As soon 
as the keyboard is unlocked following com- 
munication with the host, you may continue 
typing without pressing the Pause key. 


Press Pause again to end the pause and to 
restart the recording process. 


Now you can type the rest of the sentence: 


We are happy you approve our new line of 
sweaters. 


Press Finish to end the recording. You 

must be in application mode to finish any 
recording. Also, the session in which you are 
recording must be active. 


At this time, the record indicator (R) in the oper- 
ator information area disappears and the 
recording is saved under the unique name you 
chose. Normal keystroking resumes. 


Any time during the recording process you can 
press the Quit key to end recording and not save 
the recorded keystrokes. This function is also 
available if you are in work station control mode 
and you pressed Auto while you still had a re- 
cording window active. Also, if you are recording 
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or playing and during the process you press Re- 
cord (PF4) or Play (PF16), this message appears 
if the active window has an autokey session in 
progress: 


WS012 Cannot Play or Record: Playing or 
Recording in progress 


If an inactive window has an autokey session in 
progress, this message appears: 


WS038 Cannot begin another recording: 
Recording in progress 


Host Recording 


1. Press WS Ctrl 
2. Press Auto 
3. Press Help 


wennene AUTOKEY nanan 

VALID KEYS: 

= Record | 
Play Record 

= Erase Recrd 


Enlarge 
Next Screen 
Next O 
List Recrds 


Exit WSCTRL 
Cancel 


ie ee ee 


= Print Scrn 


Press Play (PF4), Record (PF16). or Erlnp Key. 
WSCTRL AUTO " WINDOW=C SCREEN=2 


4. Press PF16 (Record key) 
5. Type the recording name in the operator 
information area 


sree AUTOKEY anna! 
VALID KEYS; 


= Record 
= Play Record 
= Erase Recrd 


Enlarge 
Next Screen 
Next O 
List Recrds 


a a 


Remove Help 
Finish 
= Exit WSCTRL 
= Cancel 


= Print Sern 


Press the Enter key when the name is completed, 
WSCTRL AUTO REC NAME LETTER WINDOW=C SCREEN=2 
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Press Enter 
Type the information you want to record: 


7S 


Thank you for your letter of 


8. Press Pause 
9. Type the variable information: 


April 1 
10. Press Pause 
11. Continue typing information you want to 


record: 


We are happy you approve our new line of 
sweaters 


12. Press Finish 


Thank you for your letter of April 1. We are 
happy you approve our new line of sweaters. _ 
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Recording Keystrokes in a Personal 
Computer Session 


When you record keystrokes in a personal com- 
puter session, please note that pressing a key or 
a series of keys may result in long processing 
times. We suggest that when recording your 
keystrokes, manually press the Pause key two 
successive times immediately following each 
command. This prevents losing keystrokes when 
you play the recording at another time. 


Playing a Recording 


Now you will learn how to play back an auto- 
mated keying recording in the same context as 
when you recorded it. 


@ Play a notepad autokey recording only in 
notepad session. 


@ Play a host autokey recording only in a host 
session. 


@ Play a personal computer autokey recording 
in a personal computer session. 


Let’s play the recording you just recorded. 


1. Make the window active where you want to 
play the recording. 


2. It is important that you position the cursor 
where you want the recording to begin play- 
ing. Keystrokes begin appearing at the cur- 
sor position and no other chance is available 
for you to move the cursor after you enter 
work station control mode. 
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10. 


Press WS Ctrl 
Press Auto 
The following prompt appears: 


Press Play(PF4), Record(PF16), or ErInp 
key 


Press Play 
The following prompt appears: 


Enter the unique name of the recording to 
play 


Type the recording name. For our example: 
letter 


As soon as you type the first character of 
the recording name in the operator informa- 
tion area, the following prompt appears: 


Press the Enter key when the name is 
completed 


Press Enter. 


If the recording name is valid, the playing of 
recorded keystrokes is automatic and acts 
just as though it were entered from your 
keyboard. 


If you entered an invalid name, you are 
prompted with 


WS035 Correct the name and press ENTER 


You can either enter the correct recording 
name or cancel the attempt to play the auto- 
key recording by pressing the Quit key. 


11. 


12. 


13. 


If you entered a valid recording name, the 
first part of your recording has been played 
and appears in your active window. The re- 
cording stopped because you placed a pause 
in the recording. The cursor appears at the 
position where you want to type the current 
date. The operator information area con- 
tains the indicators P P. This means the 
system is playing your recording and is 
pausing. 


Note: When you play a recording with the 
automatic pause previously inserted into 
your recording, you get a pause in the same 
manner as though you pressed the Pause 
key. When typing in a host window, you can 
press a key, such as Enter or PAI, that 
causes you to communicate with the host 
system. Whenever this occurs, an automatic 
pause is inserted into the recording without 
your having to press the Pause key. As soon 
as the keyboard is unlocked following com- 
munication with the host, you may continue 
typing without pressing the Pause key. 


Type the variable information, the date, 
followed by a period. For example: 


April 1. 


To resume playing after a recording pause, 
press Pause. 


When you finish playing a recording, the auto- 
key function leaves the active window. You can 
now resume typing in the active window. 
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Playing a Recording 


1. Make the window active where you want to 
play the recording 

Press WS Ctrl 

Press Auto key 

Press PF4 (Play key) 

Type the recording name 


Pe 


wenn AUTOKEY sins 
Thank you for your letter of April 1. We are VALID KEYS: 
happy you approve our new line of sweaters 
= Record 
= Play Record 
Erase Recrd 


Enlarge 
Next Screen 
Next 0 
List Recrds 


Remove Help 
Finish 
Exit WSCTRL 
Cancel 


me tf tf 


Print Sern 


Press the Enter key when the name is completed. 


WSCTRL AUTO PLAY NAME LETTER. WINDOW-D SCREEN=2 


6. Press Enter 

7. Type in the variable information until the 
system pauses 

8. Press Pause 


{--NOTEPADI — 
Thank you for your letter of April 1. We are 


happy you approve our new line of sweaters 
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Canceling a Recording 


After you are actually playing a recording, you 
can cancel it by pressing the Quit key. 


Erasing a Recording 
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There may be times when you no longer need 
information recorded with the autokey function. 
To erase a recording: 


1. 
2. 
3. 


Press WS Ctrl 
Press Auto 
You are prompted for information: 


Press Play(PF4), Record(PF16), or ErInp 
key 


Press ErInp. 


The cursor is in the operator information 
area. The following prompt appears: 


Enter the unique name of the recording to 
be deleted 


Enter the recording name; for our example: 
letter 

Press Enter. 

If you entered a valid name and the 
recording was deleted, the following prompt 


appears: 


Erase complete: Press Play(PF4), 
Record(PF16), or ErInp 


The name you entered remains on your dis- 
play screen for possible reuse. 


If you choose not to play, record, or delete a 


recording at this point, you can leave auto- 
key by pressing Finish. 
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Notes: 


Introduction 


This chapter is for anyone who wants to save 
autokey recordings, notepad data, and screen 
profiles, before powering off, and to restore them 
to the system later. Because the IBM 3270 Per- 
sonal Computer supports different screen sizes, 
we recommend you restore information to the 
same display size that you saved from. 


Let us say, for example, that you have recorded 
your host computer logon procedure with the 
autokey function. Since this logon procedure is 
the same every time you use your computer, you 
can save it, and each time you turn on your work 
station the recording can be restored for use. 


You will also want to save screen profiles. Sup- 
pose you are working with a screen profile and 
need to stop and continue working with it 
another time. By saving the screen profile, you 
can restore it to the screen the next time you use 
your system and pick up where you left off. The 
screen profile you were last using before saving 
the screen profiles will be active when you next 
issue a restore to your system. The other screen 
profiles will be restored to the system and will 
appear when those screens are selected. You 
must save the updated autokey recordings, 
screen profiles, and notepads before you power 
off or you will lose this information. 


Save and Restore can be used only while a per- 
sonal computer window is active and the DOS 
command prompt, for example, A>, is on the 
screen. Your cursor must be in the personal 
computer window, and the window will be 
double-bordered. 


When using the Save and Restore commands, 
you can enter them in any combination of upper- 
case and lowercase characters. If you are not 
familiar with IBM Personal Computer file 
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naming procedures or notation, refer to the end 
of this chapter for a description of the formats 
and parameters used in the Save and Restore 
commands. 


After you have become familiar with Save and 
Restore commands, you may want to refer to 
Appendix F to learn how to use command proce- 
dures to simplify multiple save and restore oper- 
ations, or to provide automatic restores when 
your system is initialized. 


Note: When issuing a Save and Restore request, 
make sure that the correct diskette is in the disk 
drive specified (or in the default drive if no drive 
is specified). If any of the DOS device error mes- 
sages are issued, such as ‘“‘Diskette is write pro- 
tected,’ do not change diskettes. If the diskettes 
are changed, DOS does not guarantee the valid- 
ity of the diskette directory and the diskette 
may no longer be readable. For more informa- 
tion, refer to your DOS manual. 


Terms You Need to Know 


Restore The work station function that 
allows you to move autokey 
recordings, notepad informa- 
tion, and/or screen profiles 
from personal computer disk- 
ette or fixed disk storage to 
work station temporary 
storage. 


Save The work station function that 
allows you to move autokey 
recordings, notepad informa- 
tion, and/or screen profiles 
from work station temporary 
storage to personal computer 
diskette or fixed disk storage. 


How to Save and Restore Screen 
Profiles 


To save screen profiles: 

1. When you see the DOS prompt, type 
INDSAVE SCREEN 

2. Press Enter. 

To restore screen profiles: 

1. When you see the DOS prompt, type 
INDRSTR SCREEN 

2. Press Enter. 

Note: This only saves screen profiles, not the 

contents of the windows. When you restore the 

screen profiles, the windows will contain the data 


that was in the window when the restore was 
issued. 
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How to Save and Restore 
Notepads 


To save all notepads configured in your system: 

1. When you see the DOS prompt, type 
INDSAVE NOTEPAD 

2. Press Enter. 

To restore all notepads: 

1. When you see the DOS prompt, type 
INDRSTR NOTEPAD 

2. Press Enter. 


If you have more than one notepad and only 
want to save one, see ‘‘How to Save and Restore 
Only One Notepad,”’ later in this chapter. 


Notes: 


1. Saving a notepad saves only the contents of 
the notepad window; therefore, when you 
restore the notepad, the contents of the 
notepad window are restored while the note- 
pad window stays as it is currently defined. 
For example, if you saved a notepad that 
has red text on a blue background and later 
restored the notepad to a notepad window 
with green text on a black background, the 
restored notepad will take on the green-on- 
black color characteristics. To save the 
original color characteristics of the notepad, 
use the screen option. 


2. The first 20 bytes of the notepad data are 
reserved for use by Save and Restore 
commands. 


How to Save and Restore 
Autokey Recordings 


To save all autokey recordings: 
1. When you see the DOS prompt, type 
INDSAVE AUTOKEY 
2. Press Enter. 
To restore all autokey recordings: 
1. When you see the DOS prompt, type 
INDRSTR AUTOKEY 
2. Press Enter. 
Note: You can record an Initial Program Load 
(IPL) sequence in the personal computer session 
only if you do not have either one of the follow- 
ing commands in your autoexec.bat file: 
INDRSTR 
Or | 


INDRSTR AUTOKEY 
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How to Save and Restore All 
Screen Profiles, Notepads, and 
Autokey Recordings 


To save all the autokey recordings, notepad 
data, and screen profiles of the system at the 
same time: 


1. When you see the DOS prompt, type 
INDSAVE 
2. Press Enter. 


To restore all the autokey recordings, notepad 
data, and screen profiles of the system at the 
same time: 


1. When you see the DOS prompt, type 
INDRSTR 
2. Press Enter. 


Note: When you use the Save command this 
way (without any parameter), it saves the con- 
tent of the notepads, autokey recordings, and 
screen profiles. When you issue the Restore 
command, all windows will be restored to the 
sizings that existed when the save was done: the 
contents of the notepads will be restored. The 
contents of the host sessions are never saved or 
restored. 


How to Save and Restore Data 
in User-Named Files 


Refer to ‘‘Note on Notation’”’ at the back of this 
chapter to explain the following command for- 
mats and parameters. | 


There are four default files in your system in 
which data is saved: 


@® INDSAVE.REC: This file contains the 
three default filenames listed directly below. 


@® INDSAVE.AUT: This file contains the 
saved autokey data. 


@ INDSAVE.NOT: This file contains the 
saved notepads. 


@ INDSAVE.SCR: This file contains the 
saved screen profiles. 


You may replace the default filenames in 
INDSAVE.REC with your own filenames. The 
three filenames in INDSAVE.REC indicate 
where the saved data will be placed. Each file 
specification in your replacement for 
INDSAVE.REC must be separated from the 
next by a blank space, for example: 


INDSAVE.AUT INDSAVE.NOT 
INDSAVE.SCR — insert a blank space here 


There must also be a blank space after 
INDSAVE.SCR. The filenames must be in 
this specified order: autokey recordings 
(INDSAVE.AUT), notepad data 
(INDSAVE.NOT), and screen profiles 
(INDSAVE.SCR). 
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How to Save and Restore Screen 
Profiles 


To save screen profiles in a user-named file, 
rather than using the default files: 


1. When you see the DOS prompt, type 


INDSAVE SCREEN [d-] [path-] 
filename|.ext.] 


2. Press Enter. 


To restore all screen profiles from the file 
specification of your choice: 


1. When you see the DOS prompt, type 


INDRSTR SCREEN [d:] [path] 


filename|.ext] 


2. Press Enter. 
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How to Save and Restore Notepads 


To save all notepads configured in your 
system in a user-named save file: 


1. When you see the DOS prompt, type 


INDSAVE NOTEPAD [d:] [path| 
filename|.ext| 


2. Press Enter. 


To restore all notepads configured in your sys- 
tem in a user-named save file: 


1. When you see the DOS prompt, type 


INDRSTR NOTEPAD [d.] [path] 


filenamel.ext] 


2. Press Enter. 
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How to Save and Restore Only One 
Notepad 
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To save and restore only one notepad, use the 
NOTEPADn format, where n is replaced by the 
short name of the notepad you want to save or 
restore. 

To save one of the notepads: 


1. When you see the DOS prompt, type 


INDSAVE NOTEPADn [d:] [path] 


filename|.ext| 
2. Press Enter. 
To restore this single notepad: 
1. When you see the DOS prompt, type 


INDRSTR NOTEPADn [d:] [path] 
filenamel.ext| 


2. Press Enter. 


How to Save and Restore Autokey 
Recordings 


To save the autokey recordings in a user-named 
save file: 


1. When you see the DOS prompt, type 


INDSAVE AUTOKEY [d_] [path] 


filename|.ext] 
2. Press Enter. 
To restore these autokey recordings: 
1. When you see the DOS prompt, type 


INDRSTR AUTOKEY [a-] [path] 


filename|.ext] 


2. Press Enter. 
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How to Save and Restore All Autokey 
Recordings, Notepads, and Screen 
Profiles 
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To save all the autokey recordings, notepads, 
and screen profiles in the user-named save files: 


1. When you see the DOS prompt, type 


INDSAVE [d:| [path] 


filename|.ext] 
2. Press Enter. 


To restore all autokey recordings, notepads, and 
screen profiles: 


1. When you see the DOS prompt, type 


INDRSTR [a-] [path] 
filename|.ext] 


2. Press Enter. 


Note on Notation 


The following notation is used throughout this 
chapter: 


@ Uppercase Characters 


Words shown in capital letters indicate a 
keyword parameter. You can type keywords 
in any combination of uppercase and lower- 
case characters; however, you must spell the 
word exactly as shown. 


INDSAVE NOTEPAD 
@ Italics 


Italics indicate the kind of information, 
rather than the exact information, that 
must be supplied, for example: 


INDSAVE [d:] [path] 
filename|.ext] 


The actual entry replaces the italic descrip- 
tion. You can type the correct entry using 
any combination of uppercase and lowercase 
letters. 


@ Brackets[ | 


Brackets indicate an optional parameter. 
This includes any accompanying commas, 
colons, or periods. 


INDRSTR [ad-] [path] 
filename|.ext] 


If you want to include optional information, you 


must type only the information inside the brack- 
ets, not the brackets. 
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Format Used in User-Named 
File Specifications 


d: 
The personal computer disk drive speci- 
fier, for example, A:. If not specified, 
the system will use the default drive. 


path 
The optional personal computer DOS 
directory search order that sets the 
command search path through direc- 
tories. (Refer to “‘Specifying the Path to 
a File’, in your IBM Personal Com- 
puter Disk Operating System manual 
for further information.) 


filename 
A required positional parameter; the 
personal computer filename. 


ext 
The personal computer file extension. It 
is an optional part of the personal com- 
puter filespec. An extension starts with 
a period, has one, two, or three charac- 
ters, and follows immediately after the 
filename. An extension of more than 
three characters will be truncated to 
the first three characters entered. For 
example: 


82PRICES.AUG 
where .AUG is the extension. 
Refer to the IBM Personal Computer Disk Oper- 


ating System manual for further information on 
these parameters. 
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Notes: 
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Introduction 


This chapter is for anyone who wants to print 
data on an IBM 3270 Personal Computer- 
supported locally attached printer or on a printer 
attached to your IBM 3274 Control Unit. 


The IBM 3270 Personal Computer allows you to 
print two ways: 


@ With an IBM 3270 Personal Computer- 
supported locally attached printer that is 
attached to your system unit by a cable, you 
may print data from: 

— Personal computer windows 
— Host windows 


— Notepad windows 


@ With the printer attached to your 3274 Con- 
trol Unit, you may print data from: 


— Host windows. 


Terms You Need to Know 


Print Making a hardcopy on either 
an IBM 3270 Personal 
Computer-supported locally 
attached printer or a 3274- 
attached printer. 
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Printing on the IBM 3270 
Personal Computer-Supported 
Locally Attached Printer 


Printing What Is on the Screen 


If you want to print what is on your screen onto 
your IBM 3270 Personal Computer-supported 
locally attached printer: 


1. Press WS Ctrl. 

You are now in work station control mode. 
2. Press Print. 
Please note the following: 


@ The system prints what is on the screen, 
whether it is an enlarged personal computer 
window, host window, notepad window, or 
any combination of windows except for 
characters not supported by the graphics 
printer. 

The borders around the windows on your 
screen are also printed. 

The work station control operator informa- 
tion area (OIA) is not printed. 


To cancel the printing, press Quit. 
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Printing a Window 


In work station control mode, you can print the 
following sessions on your IBM 3270 Personal 
Computer-supported locally attached printer: 


@ host 
@ notepad 
@ personal computer. 


To do this: 


1. Select the window 
2. Enlarge it 
3. Press Print. 


To cancel the printing, press Quit. 
Note: The Print key is inactive in both host and 
notepad sessions. To print a host or notepad ses- 


sion, you must be in work station control mode, 
as described above. 
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Printing the Personal Computer 
Session 
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This procedure prints the entire presentation 
space, not just what is within the window 
borders. The output goes to the IBM 3270 Per- 
sonal Computer-supported locally attached 
printer. 


1. In application mode, the personal computer 
window must be active. | 


2. Press Shift + Print. (The Print key is equiv- 
alent to the PrtSc key of an IBM Personal 
Computer.) 


To cancel the printing, press Quit. 
Note: While in a personal computer session, 


you should not use the Print spool facility. See 
Appendix G for more information. 


Printing on the 3274-Attached 
Printer 


Printing the Host Session (Local Copy) 


This procedure prints the entire presentation 
space. For further information on local copy 
procedures, see the JBM 3278 Display Station 
Operator’s Guide, GA27-2890. 


1. In application mode, the host window must 
be selected. 


2. Press Print. (The Print key is equivalent to 
the on of a 3270 host terminal.) 


Note that if your presentation space is wider 
than the column width of your printer, the data 
wraps to the next line. 


To cancel the printing, press Quit before 
printing starts. This function is equivalent to 
that of the DEV CNCL (Device Cancel) key on 
the 3278/3279. 
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Display/Printer Compatibility 


Programmed Symbol (PS) 
Considerations 
If your printer does not have the ability to print 
programmed symbol characters as displayed on 
your screen, it substitutes the unprintable char- 
acters with ones existing in its character set. 
Therefore, your printed data may have a mixed 


appearance, with some data matching displayed 
data and some not matching the displayed data. 


Color Printing 
@ White characters are printed as black 


@® All other colors are supported 


® Only foreground color is printed 


Extended Highlighting 


If the display specifies a particular form of high- 
lighting not supported by the printer, the data is 
printed with defaults defined in the printer. 


Graphics Color Printing 
When you use the Personal Computer printer to 
print a color graphics application, the colors may 


not print as displayed on your screen. See 
Appendix G for further information. 
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Notes: 


Introduction 


This chapter is for anyone who wants to 
transfer files between a host virtual machine/ 
conversational monitor system (VM/CMS) or 
time sharing options (TSO) session and the 
personal computer session. 


File transfer allows you to send and receive files 
between a personal computer session and a host 
VM/CMS or TSO session. If modifications to the 
ASCII to EBCDIC and/or EBCDIC to ASCII 
translation tables are required, refer to the IBM 
5270 Personal Computer Introduction and Prein- 
stallation Planning manual, GA23-0179, or the 
Program Directory for the IBM host-supported 
file transfer program. The IBM host-supported 
file transfer program, No. 5664-281 for VM/CMS 
or 5665-311 for TSO, must be installed at your 
host site. You can verify that you have the host 
file transfer program by checking the name 
IND$FILE MODULE. This chapter will show 
you what commands you need to transfer files 
between the personal computer session and VM/ 
CMS, and how to transfer data sets between the 
personal computer session and TSO, with exam- 
ples of their use. : 


On this system, Send and Receive commands are 
used to transfer information between sessions. 


@ When you send a file, a copy of the file goes 
from the personal computer diskette or fixed 
disk you specify to the host session disk you 
specify. 


@ When you Receive a file, a copy of the file 
goes from the host session disk you specify 
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to the personal computer session diskette or 
fixed disk you specify. Your personal com- 
puter DOS session must always be active to 
start sending files to the host or receiving 
files from the host. 


After you have become familiar with the Send 
and Receive commands, you may want to refer 
to Appendix F to learn how to use command pro- 
cedures to simplify the transfer of multiple files. 


Error messages for various error conditions are 
listed and explained in Appendix E. 


Note: Batch files (with the extension BAT) can 
be used to change any of the default parameters 
in file transfer. For additional information, see 
the boxed note under ‘‘How to Transfer a File’’ 
later in this chapter. 


Terms You Need to Know 
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Receive One of the two commands in- 
volved in file transfer. When 
you receive a file, a copy of the 
file goes from the host session 
to the personal computer 
session. 


Send One of the two commands in- 
volved in file transfer. When 
you send a file, a copy of the 
file goes from your personal 
computer session to a host 
session. 


Format Notation for the Send 
and Receive Commands 


Examples of the formats of the VM/CMS Send 
and Receive commands are given below. The no- 
tation that follows is used to show how the Send 
and Receive commands should be formatted. 


[a:|SEND [d:][ path] filename[.ext] [id-| fn ft [fm] [(options] 


[a:]RECEIVE [d-:][ path] filename{[.ext] [id:|fn ft [fm] [(options] 


@ Uppercase Characters 


Words shown in capital letters indicate a 
keyword parameter. You can type keywords 
in any combination of uppercase and lower- 
case characters; however, you must spell the 
word exactly as shown. 


@ Italics 


Italics characters indicate the kind of infor- 
mation, rather than the exact information, 
that must be supplied. The actual entry re- 
places the italic description. You can type 
the correct entry in any combination of 
uppercase and lowercase letters. 


@ Brackets[ | 


Brackets indicate an optional parameter. 
This includes any accompanying commas or 
equals signs. If you want to include optional 
information, you must type only the infor- 
mation inside the brackets, not the brackets. 
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@® OR-sign 


The OR-sign indicates a choice of parame- 
ters. If a group of options is shown and the 
individual options are separated by OR- 
signs, one of the options in the group can be 
chosen. If none of these options is used, the 
default value is used. You must not type the 
OR-sign. 


Commas and Parentheses 


Commas and parentheses must be entered 
as shown. When they appear within brack- 
ets, they are optional and are to be used 
only if the accompanying option is used. 


How to Transfer a File 
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To transfer files, you must establish both a host 
session and a personal computer session. We 
recommend you do not have any applications 
running in a host session concurrently while per- 
forming file transfer except for FULIST. You 
must set messages off while performing a Send 
or Receive. 


1. 


Activate a host session window and estab- 
lish a host VM/CMS or TSO session. (This 
must be the session you want to transfer 
data to or from.) 


Activate your personal computer session. 
The IBM 3270 Personal Computer file 
transfer commands must be issued from the 
personal computer session, regardless of 
whether you’re sending or receiving a file. 


3. To transfer a file from the personal com- 
puter to the host, enter the IBM 3270 Per- 
sonal Computer VM/CMS or TSO file 
transfer Send command. 


4. Totransfer a file from the host to the 
personal computer, enter the IBM 3270 Per- 
sonal Computer VM/CMS or TSO file trans- 
fer Receive command. These commands are 
described on the following pages. 


5. Tocancel file transfer while it is in progress, 
press Ctrl + Break. After a brief delay, the 
Send or Receive command will be canceled. 
If the host file transfer has begun to run, it 
will also be canceled. If you wish, you may 
begin another Send or Receive. 


Note: As a precaution, when sending or receiving a file to 
replace an existing file, use a different temporary name for 
the file to be replaced. When file transfer has succeeded, 
erase the previous version of the file and rename the tempo- 
rary file. This will prevent loss of part of your original file if 
the file transfer malfunctions. If the file transfer does fail, 
you should erase the file with the temporary name. If the 
file transfer does not complete its process as it should, start 
over from the beginning and reenter the command. 


When sending or receiving a file to append an existing file, 
copy the file, using a temporary name, and transfer the file 
to the temporary file. If the file transfer fails, the original 
file is still intact and the process can be repeated for the next 
attempt. If the file transfer succeeds, you can erase the orig- 
inal, unappended file and rename the new, appended file 
with the original file name. A batch file to change the de- 
fault on the file transfer Receive command from REPlace 
to APPend is shown below: 


Type: 


a:receive Yol %2 %3 %4 %5 %6 Yo7 %8 %9 append 
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VM/CMS Send Command 


To transfer files from your personal computer 
session to a VM/CMS host session, switch to 
your personal computer session and type: 


| lesSEND [d:][path|filename[.ext] [id:|fn ft [fm] (options) 


Where: 


a: 
Is the diskette drive where the diskette with 
the file transfer commands resides. Required 
only if the Send command is not in the 
default drive, for example, A:, B:, C:, or D:. 


SEND 
Is the required command name that sends a 
file from the personal computer session to a 
host session. 


Is the personal computer diskette drive spe- 
cifier for the personal computer file to be 
transferred, for example, A:. If not specified, 
the system will use the default drive. (Refer 
to the IBM Personal Computer Disk Operat- 
ing System manual for further information.) 


path 
Is the optional personal computer DOS 
directory search order that sets the com- 
mand search path through directories. (Re- 
fer to “Specifying the Path to a File”’ in 
your IBM Personal Computer Disk Operat- 
ing System manual for further information.) 
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filename 


ext 


id: 


Is a required positional parameter, the per- 
sonal computer filename. The filename can 
be from one to eight characters in length. 
(Refer to the IBM Personal Computer Disk 
Operating System manual for further 
information.) 


Is the personal computer file extension. It is 
an optional part of the personal computer 
filespec unless the personal computer file- 
name involved in the transfer has an exten- 
sion. (Refer to the IBM Personal Computer 
Disk Operating System manual for further 
information.) An extension starts with a per- 
iod, has one, two, or three characters, and 
follows immediately after the filename. For 
example: 


82PRICES.AUG 
where .AUG is the extension. 


There must be no spaces between disk drive, 
path, filename, and extension. 


Is specified if you have more than one host 
session in the system and want to transfer a 
file to one of the host sessions. Although 
this variable is optional, you will want to 
specify it if you have more than one host 
session configured in the system. If you 
don’t specify id: and have more than one 
host session, the file transfer operation will 
be directed to the first host session confi- 
gured in your system. The id of this first 
host session is not necessarily the first in 
alphabetic order. There must be no spaces 
between id and fn. 
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fn 
Is a required positional parameter, the 
VMI/CMS file name. The filename can be 
from one to eight characters in length. 


ft 
Is a required positional parameter, the 
VMICMS file type. 

fm 
Is an optional positional parameter, the 
VMI/CMS file mode. If omitted, the default 
is Al. 

Options 


( 
Is required if specifying any of the following 
options: 


APPEND 
Allows you to attach a personal com- 
puter file to the end of a host file. The 
APPEND parameter overrides any 
other values for LRECL and RECFM. 
If APPEND is not specified when the 
filenames are the same, the personal 
computer file being transferred will 
replace the existing host file. 


ASCII 
Specifies, when a file is stored on the 
personal computer storage medium in 
ASCII form, that the file is to be con- 
verted to EBCDIC during the transfer 
for processing on the host. When 
sending text files to the host, you 
should always specify the ASCII 
parameter. This allows the file to be 
readable when on the host. 


CRLF 
Specifies whether carriage return/line 
feed characters are recognized as record 
separators and deleted before storing 
on the host storage medium. When 
sending text files to the host, it is rec- 
ommended that you always specify the 
CRLF parameter. This allows the file to 
be readable when on the host. 


LRECL n 
Specifies the logical record length of the 
host file, where n is the number of char- 
acters in each record. If LRECL is 
omitted, the default value is 80 for new 
files. If you are replacing a file, the de- 
fault is the characteristics of the exist- 
ing file. If you are appending a file, 
RECFM is ignored. When working with 
variable-length records, n is the maxi- 
mum size the host will accept. If, how- 
ever, you don’t send a record of the 
maximum size, the LRECL will become 
the longest record actually sent. 


RECFM FIV | 
Specifies the record format and charac- 
teristics of the host file. It is followed 
by one of the following characters: 


F 
Specifies that the file contains 
fixed-length records. 


Specifies that the file contains 
variable-length records. 


For new files, if RECFM is omitted, the de- 


fault is F except when the CRLF option is 
specified. V is then the default. 
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Example 


Let us say that you want to transfer a file con- 
taining a list of prices for several paper vendors, 
called PRICELST.BAS, from your personal 
computer session to a host VM/CMS session. 


1. After you are in the personal computer ses- 
sion, type the command: 


send a:pricelst.bas r:pricelst basic al (ascii crlf recfm f 


(Note that the PATH parameter was not 
specified in this example.) 


A copy of PRICELST.BAS, on a diskette in diskette 
drive A of your system unit, is sent (SEND A:) to the 
host session R:, the short 

name for the window identification, where it is renamed 
PRICELST BASIC A1. The ASCII file is converted to 
EBCDIC for processing on the host (ASCII); the carriage 
return/line feed characters are recognized as the end of a 
record and then deleted (CRLF). The file has a fixed- 
length record format (RECFM F). 


Remember, you can enter the command in 


any combination of uppercase and lowercase 
characters. 


Additional Information 
If you need additional information about the 
VM/CMS or DOS parameters, have these books 
available for reference: 


@ VM/370 CMS User’s Guide, GC20-1819 


@ JBM Virtual Machine Facility/370: CMS 
Command and Macro Reference, GC20-1818 


@ IBM Personal Computer Disk Operating 
System manual 
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VM/CMS Receive Command 


To transfer files from a VM/CMS host session to 
your personal computer session, switch to your 
personal computer session and type: 


[a-]JRECEIVE [d-][ path] filename[.ext] [id:|fn ft |fm] [Coptions] 


Where: 


a. 


Is the diskette drive where the diskette with 
the file transfer commands resides. Required 
only if the Send command is not in the 
default drive, for example, A:, B:, C:, or D:. 


RECEIVE 


Is the required command name where the 
personal computer session receives a file 
from a host session. 


Is the personal computer diskette drive spe- 
cifier for the personal computer file to be 
transferred, for example, A:. If not specified, 
the system will use the default drive. (Refer 
to the IBM Personal Computer Disk Operat- 
ing System manual for further information.) 


path 


Is the optional personal computer DOS 
directory search order that sets the com- 
mand search path through directories. 
(Refer to ‘““Specifying the Path to a File” in 
your IBM Personal Computer Disk Operat- 
ing System manual for further information.) 
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filename 


ext 


id: 


Is a required positional parameter, the per- 
sonal computer file name. The filename can 
be from one to eight characters in length. 
(Refer to the IBM Personal Computer Disk 
Operating System manual for further 
information.) 


Is the personal computer file extension. It is 
an optional part of the personal computer 
filespec unless the personal computer file- 
name involved in the transfer has an exten- 
sion. (Refer to the IBM Personal Computer 
Disk Operating System manual for further 
information.) An extension starts with a per- 
iod, has one, two, or three characters, and 
follows immediately after the filename. For 
example, 


82PRICES.AUG 
where .AUG is the extension. 


There must be no spaces between disk drive, 
path, filename, and extension. 


Is specified if you have more than one host 
session in the system and want to transfer a 
file to one of the host sessions. Although 
this variable is optional, you will want to 
specify it if you have more than one host 
session configured in the system. If you 
don’t specify id: and have more than one 
host session, the file transfer operation will 
be directed to the first host session confi- 
gured in your system. The id of this first 
host session is not necessarily the first in 
alphabetic order. There must be no spaces 
between id and fn. 


fn 


Is a required positional parameter, the 
VM/CMS file name. The filename can be 
from one to eight characters in length. 


ft 
Is a required positional parameter, the 
VM/CMS file type. 

fm 
Is an optional positional parameter, the 
VM/CMS file mode. If omitted, the default 
is Al. 

Options 


( 


Is required if specifying any of the following 
options: 


ASCII 
Specifies that the file should be stored 
on the personal computer storage 
medium in ASCII form. 


CRLF 
Specifies whether carriage return/line 
feed characters should be inserted as 
the last two characters of each line 
when a file is stored on the personal 
computer storage medium. 


APPEND 
Allows you to attach a file to the end of 
a personal computer file. If APPEND 
is not specified when the file names are 
the same, the host file being transferred 
will replace the existing personal com- 
puter file. 
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Example 


We will assume that you are finished working 
with PRICELST BASIC in your host session 
and want to send the updated version from the 
host session back to the personal computer 
session. 


1. After you are in the personal computer 
session, type the command: 


receive b:pricelst.bas r:pricelst basic al (ascii erlf 
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(Note that the PATH parameter was not 
specified in this example.) 


A copy of PRICELST.BASIC is sent to the 
diskette now in diskette drive B of your system 
unit (RECEIVE B:), from the host session R:, the 
short name for the window identification, 

where it replaces the previous file named 
PRICELST.BAS. (If you do not want to lose 
your original file, use another name in place of 
PRICELST.BAS.) The file is stored with car- 
riage return/line feed characters (CRLF). The file 
will be stored on the personal computer storage 
medium in ASCII form. 


Remember, you can enter the command in any 
combination of uppercase and lowercase 
characters. 


Additional Information 
If you need additional information about the 
VM/CMS or DOS parameters, have these books 
available for reference: 


@ VM/370 CMS User’s Guide, GC20-1819 


@ JBM Virtual Machine Facility/870: CMS 
Command and Macro Reference, GC20-1818 


@ IBM Personal Computer Disk Operating 
System manual 
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TSO Send Command 


To transfer files from your personal computer 
session to a TSO host session, switch to your 
personal computer session and type: 


[a-]JSEND [d-][ path] filename[.ext] [id:]data set name|(member name)][/password] [options] 


Where: 


a: 
Is the diskette drive where the diskette with 
the file transfer commands resides. Required 
only if the Send command is not in the 
default drive. 


SEND 
Is the required command name that sends a 
file from the personal computer session to a 
host session. 


Is the personal computer diskette drive spe- 
cifier for the personal computer file to be 
transferred, for example, A:. If not specified, 
the system will use the default drive. (Refer 
to the IBM Personal Computer Disk Operat- 
ing System manual for further information.) 


path 
Is the optional personal computer DOS 
directory search order that sets the com- 
mand search path through directories. 
(Refer to ‘“‘“Specifying the Path to a File’’ in 
your IBM Personal Computer Disk Operat- 
ing System manual for further information.) 
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filename 


ext 


id: 


Is a required positional parameter, the per- 
sonal computer file name. The filename can 
be from one to eight characters in length. 
(Refer to the IBM Personal Computer Disk 
Operating System manual for further 
information.) 


Is the personal computer file extension. It 

is an optional part of the personal computer 
filespec unless the personal computer file- 
name involved in the transfer has an exten- 
sion. (Refer to the IBM Personal Computer 
Disk Operating System manual for further 
information.) An extension starts with a per- 
iod, has one, two, or three characters, and 
follows immediately after the filename. For 
example: 


82PRICES.AUG 
where .AUG is the extension. 


There must be no spaces between disk drive, 
path, filename, and extension. 


Specified if you have more than one host 
session in the system and want to transfer a 
file to one of the host sessions. Although 
this variable is optional, you will want to 
specify it if you have more than one host 
session configured in the system. If you 
don’t specify id: and have more than one 
host session, the file transfer operation will 
be directed to the first host session confi- 
gured in your system. The id of this first 
host session is not necessarily the first in 
alphabetic order. There must be no spaces 
between id and data set name. 
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data set name 
Is a required positional parameter, the TSO 
data set name. Quotation marks may sur- 
round the combined data set name and the 
member name to show that the userid is not 
prefixed. (Refer to the IBM OS/VS2 Com- 
mand Language Reference, GC28-0646, for 
further information.) 


(member name) 
Is the name of one of the members in the 
directory of a partitioned data set. The data 
set must exist. 


/password 
Is required if password-protection has been 
specified for your TSO data set. 


Options: 


ASCII 
Specifies that the data set is stored 
on the personal computer medium in 
ASCII form. It has to be converted to 
EBCDIC during the transfer to the 
host storage medium for processing on 
the host. When sending text files to the 
host, you should always specify the 
ASCII parameter. This allows the file 
to be readable when on the host. 


CRLF 
Specifies whether carriage return/line 
feed characters are recognized as record 
separators and deleted before storing on 
the host. When sending text files to the 
host, you should always specify the 
CRLF parameter. This allows the file to 
be readable when on the host. 


APPEND 
Allows you to attach a personal com- 
puter file to the end of a host data set. 
APPEND may not be specified for 
members of a partitioned data set. The 
APPEND parameter overrides any 
other values for LRECL and RECFM. 


LRECL(n) 
Specifies the logical record length of the 
host data set, where n is the number of 
characters in each record. If LRECL is 
omitted, the default value is 80 for new 
files. If you are either appending or 
replacing records, LRECL is ignored. 
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BLKSIZE(n) 


Specifies the block size of the host data 
set, where n is the length in bytes of a 
data block. If BLKSIZE is omitted, the 
default is LRECL for new files. If you 
are appending or replacing a file, 
BLKSIZE is ignored. 


RECFM(F| V1U) 


Specifies the record format and charac- 
teristics of the data set. It is followed 
by a combination of the following 
characters: 


F 
Specifies that the data set con- 
tains fixed-length records. 
Vv 
Specifies that the data set con- 
tains variable-length records. 
U 


Specifies that the data set con- 
tains undefined-length records. 


For new data sets, the default is F ex- 
cept when the CRLF option is specified. 
V is then the default. 


SPACE(quantity[,increment)]) 


AVBLOCK(value) TRACKS 
CYLINDERS 


Specifies the amount of space to be allo- 
cated for a new data set. If SPACE is 
used, you may use one of the three 
options, - AVBLOCK (value), TRACKS, 
or CYLINDERS - to specify the units 
used for quantity and increment. If 
none of these options is specified, the 
system defaults to the value of 
BLKSIZE. 


Example 


Suppose you want to transfer a physical- 
sequential data set called DATA.BAS from 
the personal computer session to a host TSO 
session. 


1. If you are not already in a personal com- 
puter session, press WS Ctrl and select 
your personal computer session. 


2. After you are in the personal computer 
session, type the command: 


send b:data.bas r:data.basic/protects Irecl(132) recfm(f) space(20,10) tracks 


(Note that no PATH parameter was 
specified in this example.) 


A copy of DATA.BAS, on a diskette in diskette 
drive B of your system unit, is sent to the host 
session R:, the short name for the window identi- 
fication, (SEND B:), where it is renamed DATA 
BASIC. The data set is password-protected on 
the host (/PROTECTS). The logical record length 
(LRECL) has been set at 132, rather than being 
allowed to default to 80. The data set has a 
fixed-length record format (RECFM F), and 20 
TRACKS, increased by 10, have been allotted. 
(Note that not every option has been specified.) 


If DATA.BAS is a partitioned data set, an 
example of the format of the Send command is: 


send b:data.bas r:data.basic(tax1982) 
Note that neither password nor options were 
specified in this example and that a member 
name, TAX1982, is included. 
Remember, you can enter the command in 


any combination of uppercase and lowercase 
characters. 
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Additional Information 
If you need additional information about the 


TSO or DOS parameters, have these books 
available for reference: 


@ IBM OS/VS2 TSO Command Language 
Reference, GC28-0646 


@ JBM OS/VS2 TSO Terminal Users Guide, 
GC28-0645 


@® IBM Personal Computer Disk Operating 
System manual 
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TSO Receive Command 


To transfer data sets from a TSO host session to 
your personal computer session, switch to your 
personal computer session and type: 


[a:JRECEIVE [d:][ path] filename[.ext] [id:|data set name[(member name)\[/password] [options] 


Where: 


a: 


Is the diskette drive where the diskette with 
the file transfer commands resides. Required 
only if the Send command is not in the 
default drive, for example, A:, B:, C:, or D:. 


RECEIVE 


Is the required command name where the 
personal computer session receives a data 
set from the host session. 


Is the personal computer diskette drive spe- 
cifier for the personal computer file to be 
transferred, for example, A:. If not specified, 
the system will use the default drive. (Refer 
to the IBM Personal Computer Disk Operat- 
ing System manual for further information.) 


path 


Is the optional personal computer DOS 
directory search order that sets the com- 
mand search path through directories. (Re- 
fer to “Specifying the Path to a File’ in 
your IBM Personal Computer Disk Operat- 
ing System manual for further information.) 
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filename 


ext 


id: 


Is a required positional parameter, the per- 
sonal computer file name. The filename can 
be from one to eight characters in length. 
(Refer to the IBM Personal Computer Disk 
Operating System manual for further 
information.) 


Is the personal computer file extension. It 

is an optional part of the personal computer 
filespec unless the personal computer file- 
name involved in the transfer has an exten- 
sion. (Refer to the IBM Personal Computer 
Disk Operating System manual for further 
information.) An extension starts with a per- 
iod, has one, two, or three characters, and 
follows immediately after the filename. For 
example: 


82PRICES.AUG 
where .AUG is the extension. 


There must be no spaces between disk drive, 
path, filename, and extension. 


Is specified if you have more than one host 
session in the system and want to transfer a 
file to one of the host sessions. Although 
this variable is optional, you will want to 
specify it if you have more than one host 
session configured in the system. If you 
don’t specify id: and have more than one 
host session, the file transfer operation will 
be directed to the first host session confi- 
gured in your system. The id of this first 
host session is not necessarily the first in 
alphabetic order. There must be no spaces 
between id and data set name. 


data set name 
Is a required positional parameter, the TSO 
data set name. Quotation marks may sur- 
round the combined data set name and the 
member name to show that the userid is not 
prefixed. (Refer to the IBM OS/VS2 Com- 
mand Language Reference, GC28-0646, for 
further information.) 


(member name) 
Is the name of one of the members in the 
directory of a partitioned data set. The data 
set must exist. 


{password 
Is required if password-protection has been 
specified. 


Options: 


ASCII 
Specifies that the data set should be 
stored on the personal computer stor- 
age medium in ASCII form. 


CRLF 
Specifies whether carriage return/line 
feed characters should be inserted as 
the last two characters in each line 
when a data set is stored on the per- 
sonal computer storage medium. 


APPEND 
Allows you to attach a host data set to 
the end of the personal computer file. 
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Example 
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Suppose you have finished working with 
DATA.BASIC, the physical-sequential data set 
containing password-protected information, and 
want to send a revised copy from the host TSO 
session to the personal computer session. 


1. If you are not already in the personal- 
computer mode, press WS Ctrl and select 
your personal computer session. 


2. After you are in the personal-computer 
mode, type the command: 


receive b:data.bas r:data.basic/protects ascii 


(Note that no PATH parameter was speci- 
fied in this example.) 


A copy of DATA.BASIC is transferred from the 
host session to a diskette in diskette drive B of 
your system unit (RECEIVE B:), from the host 
session R:, the short name for the window identi- 
fication, where it is renamed DATA.BAS. To 
access the host data set, the password is speci- 
fied (/PROTECTS); the data set will no longer be 
protected when on the personal computer. The 
data set will be stored on the personal computer 
storage medium in ASCII form. (Note that not 
every option has been specified.) 


If DATA.BASIC is a partitioned data set, an 
example of the format of the receive command 
is: 


receive b:data.bas r:data.basic(tax 1982) 


Note that neither password nor options were 
specified in this example and that a member 
name, TAX1982, is included. 


Remember, you can enter the command in any 
combination of uppercase and lowercase 
characters. 


Additional Information 
If you need additional information about the 


TSO and DOS parameters, have these books 
available for reference: 


@® IBM OS/VS2 TSO Command Language 
Reference, GC28-0646 


@ JBM OS/VS2 TSO Terminal Users Guide, 
GC28-0645 


@ IBM Personal Computer Disk Operating 
System manual 
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Appendix A. Customizing the 
System Diskette 
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Notes: 


Introduction 


IBM provides a program to help you build a cus- 
tomized system for your IBM 3270 Personal 
Computer. This appendix shows you how to use 
this program. 


Why You Need to Customize 


The IBM 3270 Personal Computer is intended to 
operate with a connection to an IBM 3274 Con- 
trol Unit. A 3274 Control Unit can be connected 
to various hardware configurations; therefore, 
the diskettes provided with your IBM 3270 Per- 
sonal Computer contain the programs that allow 
you to operate in a variety of 3274 hardware con- 
figurations. These diskettes alone, however, are 
not usable as customized system diskettes. You 
must perform a customization procedure to build 
a system diskette that conforms to your 3274 
hardware configuration and to your personal re- 
quirements. 


The customization program is an IBM software 
product, distributed on your IBM 3270 Personal 
Computer Control Program diskette as a DOS 
formatted file labeled INDCFIG.COM. 


Customization allows you to specify your IBM 
3270 Personal Computer hardware and software 
configuration and the parameters that are com- 
patible with your 3274 hardware configuration. 
Using your selections, the customization pro- 
gram combines appropriate data files from the 
write-protected control program diskettes and 
from the IBM Personal Computer DOS diskette. 
The system that the customization program pro- 
duces is called your customized system. 
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Note: You do not have to run the customization 
program on the work station that you want to 
create a system diskette for. You can run it on 
any member of the IBM 3270 Personal Com- 
puter family, or on an IBM Personal Computer 
with a minimum of 96K bytes of memory. 


How Customization Works 


The customization program leads you through 
the customization process by displaying data on 
your IBM 3270 Personal Computer display 
screen in a series of formats called panels. You 
reply to the customization program by entering 
information from the keyboard that is attached 
to your IBM 3270 Personal Computer. 


When to Start 


You are ready to customize your system to your 
needs after installation of your IBM 3270 Per- 
sonal Computer is completed as shown in the 
IBM 8270 Personal Computer Guide to Opera- 
tions ‘Setup Instructions’’. 


Using Your Planner to Help 
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Customizing your IBM 3270 Personal Computer 
usually involves a planner and someone responsi- 
ble for the actual customization operation. The 
planner understands the 3274 hardware configu- 
ration to which the IBM 3270 Personal Com- 
puter is to be attached and the relationship the 
3274 has with the IBM 3270 Personal Computer. 
The planner also identifies the hardware configu- 
ration of the IBM 3270 Personal Computer and 
the software configuration that is wanted. The 
planner must compile the configuration informa- 
tion and supply it to the person responsible for 
customizing the IBM 3270 Personal Computer. 


Your 3274 planner should have the IBM 3270 
Personal Computer Introduction and Preinstalla- 
tion Planning manual, GA23-0179, for informa- 
tion on customizing the 3274 Control Unit. 


Terms to Know 


@® The term control program refers to the IBM 
3270 Personal Computer Control Program. 


@® The term customized system diskette refers 
to the IBM 3270 Personal Computer Con- 
trol Program diskette or fixed disk that 
is created at the end of the customization 
procedure. It contains the program(s) 
associated with the hardware and software 
configuration for which you customize. 


Before You Begin 


Make sure you have read Chapters 1 through 38 
in this manual before customizing. These three 
chapters give you an overview of the IBM 3270 
Personal Computer, including information on 
handling diskettes. 


You will need these items when you customize: 


® Your IBM Personal Computer DOS diskette 
that is distributed with the IBM Personal 
Computer Disk Operating System manual. 


@® Your IBM 3270 Personal Computer Control 


Program diskettes, which are in a clear plas- 
tic folder at the back of this manual. 
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An information worksheet from your plan- 
ner. Your planner must complete the items 
on the worksheet that have an asterisk next 
to the item number. You will be told how to 
fill in the rest of the items on the worksheet 
in the section ‘‘Completing Your Informa- 
tion Worksheet.’ 


Customization Considerations 


If you want to build your customized system on 
a diskette: 


You need to supply a blank, two-sided 
diskette. This diskette becomes your cus- 
tomized system diskette when customiza- 
tion is complete. 


You must format the diskette before you 
run the customization program. This is 
explained under ‘‘Formatting Your System 
Diskette’’ in this appendix. 


If the system that you are running the cus- 
tomization program on has only one diskette 
drive, you are required to swap diskettes in 
the drive several times as your system disk- 
ette is built. Since diskette swapping is 
somewhat time-consuming, customization 
can take several minutes to accomplish. 


If the system that you are running the cus- 
tomization program on has two diskette 
drives, you are still required to swap disk- 
ettes in the drives as your system diskette 
is built. However, because the number of 
swaps is greatly reduced, customization can 
be very fast. 


If you want to build your customized system on 
a fixed disk: 


@ Using a fixed disk to build your customized 
system makes the process easier and con- 
siderably faster. 


@ You must format the fixed disk and copy 
the DOS files onto it before it can be used. 
If you have not yet formatted your fixed 
disk, and if you intend to use it for customi- 
zation, refer to the IBM Personal Computer 
Disk Operating System manual and follow 
the procedures given for the DOS com- 
mands FDISK and FORMAT to format the 
fixed disk and to copy the DOS files onto 
the fixed disk. 


If you want to load the customization program 
from a diskette: 


@ You need the IBM Personal Computer DOS 
diskette that is distributed with the IBM 
Personal Computer Disk Operating System 
manual. 


@® You need the IBM Personal Computer Con- 
trol Program diskettes, which are in a clear 
plastic folder at the back of this manual. 


@ If the system that you are running the cus- 
tomization program on has only one diskette 
drive, you are required to swap diskettes in 
the drive several times as your system disk- 
ette is built. Since diskette swapping is 
somewhat time-consuming, customization 
can take several minutes to accomplish. 


@ If the system that you are running the cus- 
tomization program on has two diskette 
drives, you are still required to swap disk- 
ettes in the drives as your system diskette 
is built. However, because the number of 
swaps is greatly reduced, customization can 
be very fast. 
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If you want to load the customization program 
from a fixed disk: 


@® Using a fixed disk to build your customized 
system makes the process easier and consid- 
erably faster. 


@® You must format the fixed disk and copy 
the DOS files onto it before it can be used. 
If you have not yet formatted your fixed 
disk, and if you intend to use it for customi- 
zation, refer to the JBM Personal Computer 
Disk Operating System manual and follow 
the procedures given for the DOS com- 
mands FDISK and FORMAT to format the 
fixed disk and to copy the DOS files onto 
the fixed disk. 


@® You must copy the contents of the IBM 
3270 Personal Computer Control Program 
diskettes onto the fixed disk before you can 
run the customization program. The copy 
process is explained under ‘‘Copying the 
IBM 3270 Personal Computer Control Pro- 
gram onto the Fixed Disk’’. 


Recustomizing from a 
Previously Created System 


If you have already created a customized system 
diskette, you can use it for recustomization in 
one of three ways: 


i, 


You can make a copy of your customized 
system diskette and run the copy on another 
system that has exactly that same configu- 
ration as the one on your original custom- 
ized system diskette. To copy your 
customized system diskette, you can use the 
DISKCOPY command, described in the 
IBM Personal Computer Disk Operating 
System manual. 


You can use the values you selected on your 
customized system diskette as the default 
values to display on the customization pan- 
els when you create another customized sys- 
tem diskette. Using this method, you can 
change only those options that need to be 
changed for the system you are configuring. 
The DEFAULTS option on the Home Panel 
allows you to specify where to read the 
default values from. 


You can update values on your customized 
system diskette by specifying it as both the 
default and the target for customization. 
The DEFAULTS and TARGET options, 
both on the Home Panel, allow you to spec- 
ify where to read the default values from 
and where to create the customized system. 


Note: If you want to change either the 3274 
option or the HOST option (items 19 and 20 
on the information worksheet), method 3 
will not work. You will have to format your 
customized system diskette and re-run the 
customization program. 
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The customized system diskette contains two 
DOS formatted files, INDCFIG.DAT and 
INDCFIG.FIL. INDCFIG.FIL contains, in 
printable format, the contents, or image, of the 
display panels as they existed during customiza- 
tion when that system was built. You can print 
this file using the DOS PRINT command. 
INDCFIG.DAT is the customization table that 
contains, in internal format, the same informa- 
tion as INDCFIG.FIL. This is the file that the 
customization program reads the default values 
from when you specify a drive for the 
DEFAULTS option. 


Completing Your Information 
Worksheet 


Your planner is responsible for completing the 
items on the information worksheet that have an 
asterisk next to the item number. You are re- 
sponsible for completing the rest of the items on 
the information worksheet, specifically items 1 
through 18. This section tells you how to com- 
plete those items. 


Item 1 


Item 1 asks you which drive the default configu- 
ration table is to be taken from. If you are recus- 
tomizing, this is the drive that contains a 
previously-customized system. 


Item 2 


Item 2 asks you which drive the customization 
program should write the customized system to 
when it is finished. 


Item 3 


Item 3 asks you for the type of display unit that 
is attached to the system you are customizing. 
Compare your display to the ones shown here. If 
you do not have the display you are customizing 
for available, check with your planner to get the 
display number. 


guuttnl 
wane 


5272 Color Display 


5151 Monochrome Display 
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Item 4 


Item 4 asks you for the type of printer that is at- 
tached to the system you are customizing. Com- 
pare your printer to the ones shown here. If the 
printer you are using does not match the pic- 
tures, or if you do not have the printer you are 
customizing for available, check with your sys- 
tem planner to get the printer number. 


5152 Graphics Printer 


5182 Color Printer 


Items 5 through 18 


Items 5 through 18 ask you for short and long 
session names for the customized system. 


You must specify a short name for each session 
that you are including in this customization. 
(Your planner specifies the number of host ses- 
sions to customize for on the information work- 
sheet). Short names are used as ‘“‘nicknames’”’ for 
your sessions. 


Short names must be: 
@ unique 

@ one-character 

@ alphabetic 


The session definitions panel gives these short 
name defaults: 


@ FE for host session 1 

@ A for the personal computer session 

You can change these defaults if you wish. 

Long names are optional. Choose long names 
that are meaningful to you and the way that you 
use your sessions. 

A long name can be up to eight alphanumeric 
characters long, and it must begin with an alpha- 
betic character. 

The sessions definitions panel gives these long 
name defaults when you specify a short name for 
a session: 

@ HOST! for the first host session 

HOST2 for the second host session 

HOSTS for the third host session 

HOST4 for the fourth host session 
NOTEPADI for the first notepad session 


NOTEPAD2 for the second notepad session 


PC for the personal computer session 


You can change these defaults if you wish. 
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Preparing for Customization 


Prepare to customize as follows: 


1. Set your system unit On/Off switch to Off 
before you begin. 


2. Ifyou want to load the customization pro- 
gram from a fixed disk: 


a. Make sure your system unit diskette 
drive is empty. 


b. Make sure the diskette drive door is 
open. 


c. Skip to step 4. 


3. If you want to load the customization pro- 
gram from a diskette: 


a. Make sure your system unit diskette 
drive A is empty. 


b. Insert your IBM Personal Computer 
DOS diskette in drive A. 


c. Close the drive door. 
4. If you have a 5272 display, turn it on. 


5. Set your system unit On/Off switch to On 
and wait while DOS is loaded into memory. 


6. Respond to the DOS date and time prompts. 
7. You will see the DOS prompt. 


A >(C> if DOS is on your fixed disk) 


If you do not want to load the customiza- 
tion program from a fixed disk, skip to 
the section ‘“‘Formatting Your System 
Diskette’. 


If you want to load the customization pro- 
gram from a fixed disk, you must copy the 
control program diskettes onto the fixed 
disk. The next section, ‘“‘Copying the IBM 
3270 Personal Computer Control Program 
onto the Fixed Disk’”’ explains how to do the 


copy. 


Copying the IBM 3270 Personal 
Computer Control Program onto 
the Fixed Disk 


Note: If you have not yet formatted your fixed 
disk, refer to the IBM Personal Computer Disk 
Operating System manual and follow the proce- 
dures given for the DOS commands FDISK and 
FORMAT to format the fixed disk and to copy 
the DOS files onto the fixed disk. 


To load the customization program from a fixed 
disk, you must copy the contents of the control 
program diskettes onto the fixed disk before cus- 
tomizing as follows: 


1. 


Insert the first control program diskette in 
the diskette drive. 


Close the drive door. 
Type 
copy a:*.* ¢: 


Press Enter. 


Customizing the System Diskette A-15 


5. You will see a list of the files that are being 
copied. When the contents of that diskette 
have been copied onto the fixed disk, you re- 
ceive the message 


nn File(s) copied 
The nn indicates how many files were cop- 


ied. You also see the DOS prompt A> (C> 
if DOS is on your fixed disk) 


6. For each of the additional control program 
diskettes: 


a. Remove the diskette that is in the 
drive. 


b. Insert the next control program disk- 
ette in the drive. 


c. Repeat steps 2 through 5 above. 
7. When all of the control program diskettes 
have been copied onto the fixed disk, go on 


to the section ‘‘Formatting Your System 
Diskette’’ on the next page. 
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Formatting Your System Diskette 


Before you can build your customized system on 
a device, that device must be formatted. 


To format a fixed disk: 

— Refer to the IBM Personal Computer 
Disk Operating System manual and 
follow the procedures given for the DOS 
commands FDISK and FORMAT to 


format the fixed disk and to copy the 
DOS files onto the fixed disk. 


— After your fixed disk is formatted, go 
to the section ‘‘Loading the Customiza- 
tion Program’’. 


To format a diskette: 


Before you attempt to format a diskette, 
remember: 


— The diskette must be two-sided. 

— Since formatting erases any data that is 
already on the diskette, be sure that the 
diskette you are formatting is blank. 

1. When you see the DOS prompt 
A> (C> if DOS is on your fixed disk) 
Type 
format a:/s 
2. Press Enter. 
3. When the system is ready, you are 
prompted to insert a new diskette in drive 


A, and to press any key when ready. 


a. Remove any diskette that may be in 
drive A. 
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b. Insert your blank diskette in drive A. 
c. Close the drive door. 


d. Press any alphanumeric key to begin 
the formatting. 


As formatting takes place, 
Formatting... 
is displayed. When formatting is completed, 
Formatting...Format Complete 
is displayed. 
Files from the DOS diskette are copied 
onto the blank diskette. When the copy is 
completed, 
system transferred 
nnnnn bytes total disk space 
nnnn bytes used by system 
nnnnn bytes available on disk 
Format another (Y/N)? 
is displayed. 
Type n. The DOS prompt 
A> (C> if DOS is on your fixed disk) 


reappears, indicating that formatting is 
complete. 


The newly-formatted diskette is now 
referred to as your system diskette, even 
though at this stage it does not contain all 
the necessary files. 


Remove your system diskette from diskette 
drive A. 


Now that your system diskette has been for- 
matted, you are ready to start customizing. Go 
to ‘‘Loading the Customization Program”’ below. 


Loading the Customization Program 
When you have done the preliminary steps 
necessary to run the customization program, you 
can start customization as follows: 


@ If you are loading the customization pro- 
gram from a fixed disk: 


1. You will see the prompt 
C> 

2. Type 
indcfig 


3. Press Enter to load and run the cus- 
tomization program. 


@ If you are loading the customization pro- 
gram from a diskette: 


1. Make sure diskette drive A is empty. 
2. Put the first control program diskette 
in diskette drive A and close the disk- 
ette drive door. 
3. You will see the prompt 
A> 
4. Type 
indcfig 
5. Press Enter to load and run the cus- 


tomization program. 
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When the customization program is completely 
loaded, it clears the display screen and displays 
the first customization panel. 


The Customization Panels 
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The customization program displays panels on 
which you enter or select the options for the sys- 
tem you are customizing. These panels are: 


@ The Home Panel 
The Hardware Options Panel 


The Sessions Definitions Panel 


@ 

@ 

@ The Attachment Options Panel 
@ The Host Session Options Panel 
@ 


The Customization Summary Panel 
The Customization in Progress Panel 


These panels are described on the following 
pages. 


Remember, most of the items on the customiza- 
tion panels depend on the configuration of your 
3274 Control Unit. The information on how the 
3274 is configured should be provided by the 
planner. 


The customization program has a global help 
panel that tells you how to use the customiza- 
tion panels. You can display the global help 
panel by pressing PF 1. Other help panels are 
also available. These panels will be described in 
the section ‘“‘Help panels’’. 


How to Use the Customization Panels 


The customization program presents you with a 
series of panels relating to your IBM 3270 Per- 
sonal Computer and how you want to use it. 
These panels contain lists of options, many of 
which have default values associated with them. 
You can change the values of these options to 
meet your own requirements. Other options 
require a value to be typed in. 


The program only displays options that are valid 
for your particular work station. As you change 
the default values on the customization panels, 
the program removes from the panels any items 
that no longer apply to your configuration. For 
example, if you select DFT on the Attachment 
Options panel, items relating to CUT are no 
longer displayed on the panels. 


Entry Fields and Selectable Fields 


The customization panels display two types of 
fields: 


@® Entry fields 


There are two kinds of entry fields, required 
entry fields and optional entry fields. 


Required entry fields are displayed in white 
on the 5272 display and in high intensity on 
the 5151 display. Optional entry fields are 
displayed in green on the 5272 display and 
in normal intensity on the 5151 display. If 
an entry field has a default value, you can 
change it by moving the cursor under the 
default value and typing the value you 
want. If the entry field has no default value 
assigned to it, move the cursor to the posi- 
tion indicated and type in the value you 
want to specify. 
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Selectable fields 


Selectable fields display a selected value for 
an option, and a list of other choices below 
the selected option. The selected value in a 
selectable field is displayed in reverse-video 
white on a 5272 display and in reverse video 
on a 5151 display. The rest of the options 
for a selectable field are displayed in blue on 
a 5272 display and in normal intensity on 
the 5151. To change the selected value, use 
the TAB key or the cursor move keys to 
move the cursor under the value you want 
to select, and press PF2. The new selected 
value is displayed as described for the type 
of display you are using. 


Note: On the summary panel, selectable 
fields do not have the list of choices dis- 
played below the selected option. To change 
a selectable option on the summary panel, 
move the cursor under the selected value 
and press PF2. The next choice in the list 
will appear as the selected value. By contin- 
uing to press PF2, you will see each of the 
available choices for the selectable option. 
Keep pressing PF2 until the value you want 
appears as the selected value. 
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To get to the next panel, press PgDn. 
To get to the previous panel, press PgUp. 
To get to the summary panel, press End. 


To get to the first panel (the Home panel), 
press Home. 


How to Exit From the Customization 


Program 


® To exit from the customization program, 


press Esc. 


Help panels 


While you are using the customization program, 
you can press PF 1 to display help panels. 


There are four different types of help panels: 


1; 


Global help panel 


The global help panel gives you general 
advice on how to use the customizatio pro- 
gram. The very first time you press PF1 
from one of the customization panels, you 
will get the global help panel. After that, to 
get the global help panel you have to go toa 
customization help panel or an option help 
panel and press PF 1. It tells you how to 
move from panel to panel, and how to 
change the default values. 


Customization help panels 


Each customization panel has its own help 
panel, which is obtained by pressing PF1 
when the customization panel itself is dis- 
played. The help panel gives a description of 
the panel and a list of the options whose de- 
fault values can be changed. 


Option help panels 
Some of the options also have their own help 
panel. When you display the help panel for a 


particular customization panel, move the 
cursor under the option you want to know 
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more about, and press PF2. You will get a 
help panel giving more details about that 
option. You can return to the customization 
help panel for this option by pressing Home. 


Summary help panel 


When you are at the Customization Sum- 
mary panel, you can press PF1 to get the 
summary help panel. To re-display the op- 
tion help panel for any of the options listed 
on the summary help panel, move the cursor 
under the option and press PF2. 


Remember: 


To quit help and go back to the customiza- 
tion panel, press Esc. 


To display the global help panel, press PF1 
when you are calling for help for the first 
time from a customization panel, or when 
you are in any other help panel. 


To display the option help panel for an op- 
tion on the customization help panel, move 
the cursor under the option and press PF2. 


To return to the customization help panel 
from an option help panel, press Home. 


Home Panel 


The first panel is called the home panel. 


Home panel TBM CORPORATION 
3270 PERSONAL COMPUTER CUSTOMIZATION 


Level 1.20 Copyright IBM Cor:. 1983, 1984 


Refer to the CONTROL PROGRAM USER'S GUIDE AND REFERENCE. 


Move cursor under cach desired option and press PF2 to select. 


DEFAULTS None Use IBM-supplied default values 

A Default values from diskette drive A 

(C Default values from fixed disk drive © 
TARGET A Create System on diskette drive A 

c Create System on fixed disk drive Cc 
DISPLAY ees 3270PC Color 

515] PC) Monochrome 
PP1l=Help PgDn=Next Bnd=Summary EserQuit 


On this panel you are shown three options: 
@® DEFAULTS 


This option tells the customization program 
which diskette or fixed disk drive to read 
from to obtain the values from a previously- 
customized system. These values are shown 
as the default values on the rest of the cus- 
tomization panels. If you choose to read the 
defaults from one of your diskettes instead 
of using the IBM-supplied default values, be 
sure that the correct diskette is in the drive 
before you make the selection, because the 
customization program attempts to read the 
customization table from that diskette as 
soon as you press PF 2. 


Customizing the System Diskette A-25 


A-26 


@ TARGET 


This option tells the customization program 
which diskette or fixed disk drive to write 
the customized system to. 


Note: For the DEFAULTS and TARGET 
options, the values that are displayed cor- 
respond to the number and type of drives on 
the system that you are using to run the 
configuration program. For example, for 

the TARGETS option, a system with two 
diskette drives has the values A and B dis- 
played, with B as the default. 


@® DISPLAY 
This option tells the customization program 
the type of display you have on the system 
you are customizing for. 


To display help panels, press PF 1. 


When you are ready to go to the the next panel, 
press PgDn. 


Remember: 


If you want to go to the Summary Panel, 
press End. 

- If you want to quit the customization pro- 
gram, press Esc. 


Hardware Options Panel 


The second panel is called the hardware options 
panel. 


Panel 2 HARDWARE OPTIONS 


Move cursor under the desired option and press PF2 to select. 


PRINTER None No printer attached 
5152 PC Graphics 
5182 PC Color 
3852 PC Color 


PFl=Help PgDn=Next PgUp=Prev Home=Home End=Summary Esc=Quit 


On this panel you are shown one option, 
PRINTER. This option tells the customization 
program the type of printer you have on the sys- 
tem you are configuring for. 


To display help panels, press PF 1. 


When you are ready to go to the the next panel, 
press PgDn. 


Remember: 


- If you want to return to the previous panel, 
press PgUp. 

- If you want to return to the Home Panel, 
press Home. 

- If you want to go to the Summary Panel, 
press End. 

- If you want to quit the customization pro- 
gram, press Esc. 
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The third panel is called the session definitions 
panel. 


Panel 3 SESSION DEFINITIONS 


Move cursor and type the required information. 
Enter a unique short name for each session desired. 
The long name is optional. 


SHORT LONG 


NAME NAME 
HOSTL E HOST1... Name of host session 1 
HOST2 : Name of host session 2 (DFT only) 
HOST3 : Name of host session 3 (DFT only) 
HosT4 . Name of host session 4 (DFT only) 
NOTEPAD] . Name of notepad session 1 
NOTEPAD2 . Name of notepad session 2 
PC A PCs Ss Name of PC session 


PFl=Help PgDn=Next PgUp=Prev Home=Home End=Summary Esc=Quit 


On this panel you must enter a short name for 
each session you wish to include in your customi- 
zation. Initially, this panel shows default short 
and long names for one host session and the per- 
sonal computer session. You can change these 
default names if you wish. When you enter a 
short name for any additional session, a default 
long name is displayed for that session also. You 
can change the default long name if you wish. If 
you do not want a session, leave the short name 
blank. 


To display help panels, press PF 1. 


When you are ready to go to the the next panel, 
press PgDn. 


Remember: 


- If you want to return to the previous panel, 
press PgUp. 

- If you want to return to the Home Panel, 
press Home. 

- If you want to go to the Summary Panel, 
press End. 

- If you want to quit the customization pro- 
gram, press Esc. 


Attachment Options Panel 


The fourth panel is called the attachment op- 
tions panel. 


Panel 4 ATTACHMENT OPTIONS 


Move cursor under each desired option and press PF2 to select. 
Changes can affect the display of other options on the panel. 


3274 DFT Distributed Function Terminal 
CUT Control Unit Terminal 

HOST SNA Host uses SNA attachment 
non-SNA Host uses non-SNA attachment 

EDS Yes 3274 supports Extended Data Stream 
No 

SCS Yes 3274 has SCS format override 
No 

VMClear Yes 3274 has VMClear option 
No 

INVCC Error Error sent on invalid control code 
Hyphen Hyphen shown for invalid control code 


PFl=Help PgDn=Next PgUp=Prev Home=Home End=Summary Esc=Quit 


On this panel you are shown up to six options: 
@ 3274 
This option tells the customization program 
how your 3270 Personal Computer commu- 


nicates with the 3274 Control Unit. CUT 
(Control Unit Terminal) mode allows one 
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host session to run. DFT (Distributed Func- 
tion Terminal) allows up to four host ses- 
sions to run. 


— If you select CUT for this option, the 
rest of the options on the panel become 
invalid for your configuration and are 
no longer displayed. 


— If you entered short names for more 
than one host session on the sessions 
definitions panel, CUT is not displayed 
as an option. 


HOST 


This option tells the control program 

which protocols to use to communicate with 
the host. This option is not shown if you 
selected CUT for the 3274 option. 


EDS 


This option tells the control program that 
it can use extended attributes in the data 
stream. This option is not shown if you 
selected CUT for the 3274 option. 


SCS 


This option tells the control program that 
your 3274 Control Unit has the SNA charac- 
ter string format override capability. This 
option is not shown if you selected CUT for 
the 3274 option, or non-SNA for the HOST 
option. 


VMClear 


This option tells the control program 
whether the VMClear option is installed in 
your 3274 Control Unit. This option is not 
shown if you selected CUT for the 3274 
option, or SNA for the HOST option. 


@® INVCC 


This option indicates what the 3274 Control 
Unit response is when an invalid control 
code appears in the data stream. This option 
is not shown you selected CUT for the 3274 
option. 


To display help panels, press PF 1. 


When you are ready to go to the the next panel, 
press PgDn. 


Remember: 


- If you want to return to the previous panel, 
press PgUp. 

- If you want to return to the Home Panel, 
press Home. 

- If you want to go to the Summary Panel, 
press End. 

- If you want to quit the customization pro- 
gram, press Esc. 
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One of these panels appears for every host ses- 
sion you entered a short name for on the session 
definitions panel. The short and long names of 
the session that this panel applies to are dis- 
played on the upper right corner of the panel. 


This panel does not appear if you selected CUT 
for the 3274 option on the Attachment Options 
panel. 


Panel 5.1 HOST SESSION OPTIONS SESSION NAME: E HOSTL 


Move cursor under the desired option and press PF2 to select. 


ROWSXCOLS 24x80 Model 2 screen 
32x80 Model 3 screen 
43x80 Model 4 screen 
27x132 Model 5 


screen 


PS Yes No session owns the programmed symbol sets 
No 

EAB Yes This session has extended attribute buffer 
No 


PFi=Help PgDn=Next PgUp=Prev Home=Home End=Summary Esc=Quit 


On this panel you are shown three options: 
@® ROWSxCOLS 


This option tells the control program the 
size of the host presentation space. The 
selections shown are for models of the 3278 
display. 


PS 


This option tells the control program which 
host session supports the programmed sym- 
bol sets. You can allocate the programmed 
symbol sets to only one host. Initially, the 
programmed symbols sets are not allocated 
to any host session. If you select YES to al- 
locate the programmed symbol sets to the 
host session being displayed, the message 
next to the PS option changes to read 


E HOST 1 owns the programmed symbol sets 


When the programmed symbol sets have 
been allocated to a host session other than 
the one this panel is for, the name of that 
host session is displayed in the message 
next to the PS option. 


EAB 


This option tells the control program to allo- 
cate memory for an extended attribute 
buffer for this host session. 


Note: If you select NO for the EAB option 
for this host session, the PS option becomes 
invalid for this host session and is no longer 
displayed. 


To display help panels, press PF 1. 


When you are ready to go to the the next panel, 
press PgDn. 


Remember: 


If you want to return to the previous panel, 
press PgUp. 

If you want to return to the Home Panel, 
press Home. 

If you want to go to the Summary Panel, 
press End. 

If you want to quit the customization pro- 
gram, press Esc. 
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Remember: 


- If you want to return to the previous panel, 
press PgUp. 

- If you want to return to the Home Panel, 
press Home. 

- If you want to go to the Summary Panel, 
press End. 

- If you want to quit the customization pro- 
gram, press Esc. 
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The customization summary panel displays all 
the information about the customized system on 
one panel. 


Panel 7 CUSTOMIZATION SUMMARY 


To change values, move cursor to the field and either type 
the new value, or press PF2 until the desired value appears. 
Changes can affect the display of other options on the panel. 


Display Printer 
Hardware 5272 5152 
3274 Host EDS SCS VMClear INVCC 
Attachment DFT SNA Yes Yes Yes Error 
SL Name Screen PS EAB 
Host Sessions E HOST1 24x80. Yes Yes 
F HOST2 32x80. No Yes 
x No No 
x No No 
PC Boo PC rentte es 
Notepads C NOTEPAD] 


Press PF3 to create system with the above configuration. 


PF1l=Help PgUp=Prev Home=Home Esc=Quit 


To change the value of a selected field, move the 
cursor under the value, and press PF2 until the 
desired value is displayed. 


To change the value of an entry field, move the 
cursor under the entry you wish to change and 
type over the value displayed. 


The value of a changed option is checked when it 
is entered or selected. If the new value conflicts 
with the value for a related option on the panel, 
you must change the value of the related option 
first. 


If the changed entry is invalid, the cursor re- 
mains in the same place, a warning message 
appears, and the entry is highlighted. It remains 
highlighted until you correct it, or change any 
other related values. If you leave this panel and 
then return to it, the value that existed before 
the invalid entry was made is displayed. If you 
press PF3 while an invalid option is displayed, 
the message 


CU025 Cannot customize system with incorrect values 
is displayed. 


Notes: 


1. If you change the value of the 3274 option 
to CUT, options Host, EDS, SCS, VMClear, 
INVCC, PS and EAB become invalid and 
are no longer displayed on the panel. 


2. If you change the value of the Host option 
to non-SNA, the SCS option becomes in- 
valid for your configuration and is no longer 
displayed. If you change the value of the 
Host option to SNA, the VMClear option 
becomes invalid for your configuration and 
is no longer displayed. 


3. You cannot change the value of the PS 
option for a host session to YES if another 
host session has YES selected for its PS 
option. You must change the value of the 
PS option to NO for the host session that 
originally had the programmed symbol sets 
allocated to it, and then you can assign the 
programmed symbol sets to another host 
session. 
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4. If you change the value of EAB for a host 
session to NO, the PS option for that host 
session becomes invalid and is no longer 
displayed. 


To display the summary help panel, press PF 1. 


When you are ready to create the customized 
system, press PF3. 


Remember: 


- If you want to return to the previous panel, 
press PgUp. 

- If you want to return to the Home Panel, 
press Home. 

- If you want to quit the customization pro- 
gram, press Esc. 


Customization in Progress Panel 


The customization in progress panel is displayed 
after you press PF3 to create your customized 
system. 


Panel 8 CUSTOMIZATION IN PROGRESS 


Insert diskettes as requested. 


REMAINING NN Files still to be copied 

TOTAL XX Files needed for your system 

SOURCE A IBM files are on diskette drive A 

TARGET B System will be created on diskette drive B 


PF1l=Helry Esc=Quit 


The value displayed for SOURCE reflects the 
number and type of drives on the system you are 
running the configuration program on. The value 
displayed for TARGET is the value you selected 
for the TARGET option on the HOME panel. 


You may be prompted to insert diskettes while 
the customization program is running. Follow 
the prompts. You can refer to Appendix E, 
“Using Messages”’ for explanations of the 
prompting messages. When you are prompted to 
insert a diskette into a drive, first be sure that 
the in-use light is not on for that drive. If you in- 
sert an incorrect diskette in response to one of 
the prompting messages, the message 


CU036 Incorrect diskette 


is displayed. Remove the incorrect diskette and 
insert the correct one. 
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The number ‘“‘NN”’ is updated as the necessary 
files are copied from the Control Program device 
to the customized system device. 


If you need to cancel the customization program 
before the customized system is created, press 
Esc. The message 


CU015 Customization incomplete-no system configured 


is displayed. This message tells you that the cus- 
tomization program did not finish copying all of 
the required files to the customized system disk- 
ette. You will not be able to use the system on 
that diskette. 


Note: If you forget to format your customized 
system device, the customization program dis- 
plays the messages 


CU031 System diskette requires formatting 


CU032 Type drive letter for DOS diskette and press PF3 
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Type the letter for the drive that contains the 
DOS programs (including FORMAT.COM) and 
press PF3. The customization program formats 
your customized system device and copies the 
DOS files to it, and then creates the customized 
system. 


The customization program creates a DOS file 
called AUTOEXEC.BAT on the customized sys- 
tem diskette. This file contains a statement that 
the system supplies at the conclusion of the cus- 
tomization task. Do not alter or remove this 
statement. You may include other DOS com- 
mands in AUTOEXEC.BAT, but be sure that 
they follow the statement that the system 
supplies. 


Customization Wrap Up 
1. After the customization program completes 
copying the necessary files for your custom- 
ized system, it displays the message 


CU035 Customization complete 


and displays the Customization Summary 
panel again. At this point, you can either: 


@ Change values if necessary and press 
PF8 to create another customized sys- 
tem diskette 


@ Press Esc to quit the customization 
program. 


2. Label your customized system diskette ap- 
propriately. 


3. You should make backup copies of your cus- 
tomized system diskette for future use. 
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Estimating Memory Size 


Each application you may want to use on the IBM 3270 Personal 
Computer requires some memory to run. To determine the amount 
of memory that is available, use the following factors to estimate 
memory size for various customized configurations of the IBM 
3270 Personal Computer. 


Memory 
Function Increment 
Choose one: 
Control Unit Terminal (CUT) mode 108000 bytes 
Distributed Function Terminal (DFT) mode : 
Non-SNA 153000 bytes 
SNA 162000 bytes 
Add for each DFT session (maximum of four): 
1920 characters (Model 2), no EAB (4-color) 1968 bytes 
1920 characters (Model 2), EAB (7-color) 3888 bytes 
2560 characters (Model 3), no EAB (4-color) 2624 bytes 
2560 characters (Model 3), EAB (7-color) 5184 bytes 
3440 characters (Model 4), no EAB (4-color) 3526 bytes 
3440 characters (Model 4), EAB (7-color) 6966 bytes 
3564 characters (Model 5), no EAB (4-color) 3618 bytes 
3564 characters (Model 5), EAB (7-color) 7182 bytes 
Add for each notepad session (maximum of 2): 
For 5151 or 5272 displays: 3840 bytes 
For graphics printer: 4096 bytes 
Configuration Total: 
For local applications, add: 
IBM Personal Computer DOS session 24,000 bytes 


The balance of the memory capacity is available for local applica- 
tion use. IBM 3270 Personal Computer applications that run un- 
der IBM Personal Computer DOS have the following application 
storage requirements: . 


Save/Restore 11300 bytes File Transfer 20600 bytes 
Patch 7800 bytes Tutorial 25220 bytes 


Note: Local applications may require additional memory. 
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Information Worksheet 


This worksheet should be completed before customizing the IBM 
3270 Personal Computer system diskette. An asterisk (*) next to 
certain items indicate which should be answered by the 3274 
Control Unit planner/customizer. 


* Date Planned: / / Date Customized: / / 


Identity of newly created system diskette: eee 


*Port Address: 


*Number of host sessions this system will support: 


Home Panel: 


1. Default configuration table to be taken from 
disk drive: 


2. System diskette to be created on disk drive: 
3. Type of display unit attached: (5272, 5151) 
Hardware Options Panel: 


4. Type of printer attached: (5152, 5182, 
3852, None) 


Sessions Definitions Panel: 

5. Host session 1 short name is: 

6. Host session 1 long name is: 

7. Host session 2 short name is (DFT only): 

8. Host session 2 long name is (DFT only): 

9. Host session 3 short name is (DFT only): 
10. Host session 3 long name is (DFT only): 
11. Host session 4 short name is (DFT only): 
12. Host session 4 long name is (DFT only): 


13. Notepad session 1 short name is: 


*To be answered by the 3274 Control Unit planner/customer 
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Sessions Definitions Panel (continued): 


14. 


15. 


16. 


17. 


18. 


Notepad session 1 long name is: 

Notepad session 2 short name is: 
Notepad session 2 long name is: 

Personal computer session short name is: 


Personal computer session long name is: 


Attachment Options Panel: 


*19, 


*20, 


a le 


#22. 


#28. 


*24. 


3274 attachment mechanism is for: 
CUT or DFT 


3274 host attachment mechanism is: SNA 
or non-SNA 


Does 3274 have Extended Data Stream 
(EDS) support? Yes or No 


Does 3274 have SNA character set (SCS) 
override? Yes or No 


Does 3274 have VM clear support? 
Yes or No 


Action to be taken on invalid control codes: 


Error or Hyphen 


(DFT only) 
(DFT only) 
(DFT, SNA 


only) 


(DFT, non- 
SNA only) 


(DFT only) 


Host Sessions Options Panel for host session 1 (DFT only): 


*25. 


26. 


*27,. 


Host session 1 screen size is: 


Host Session 1 Programmed Symbol (PS) usage: Yes or No 


If Yes, must specify Yes for 27 also 


Host Session 1 Extended Attribute Buffer (EAB) usage: 


Yes or No 


Host Sessions Options Panel for host session 2 (DFT only): 


*20. 


*26. 


*27. 


Host session 2 screen size is: 


Host Session 2 Programmed Symbol (PS) usage: Yes or No 


If Yes, must specify Yes for 27 also 


Host Session 2 Extended Attribute Buffer (EAB) usage: 


Yes or No 


*To be answered by the 3274 Contro! Unit planner/customer 


Host Sessions Options Panel for host session 3 (DFT only): 
*25. Host session 3 screen size is: 


*26. Host Session 3 Programmed Symbol (PS) usage: Yes or No 
If Yes, must specify Yes for 27 also 


*27. Host Session 3 Extended Attribute Buffer (KAB) usage: 
Yes or No 
Host Sessions Options Panel for host session 4 (DFT only): 


*25. Host session 4 screen size is: 


*26. Host Session 4 Programmed Symbol (PS) usage: Yes or No 
If Yes, must specify Yes for 27 also 


*27. Host Session 4 Extended Attribute Buffer (HE AB) usage: 
Yes or No 


*To be answered by the 3274 Control Unit planner/customer 
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Notes: 


Introduction 


This appendix is for those responsible for prob- 
lem determination. If there is an obvious or 
apparent hardware problem, refer to the JBM 
3270 Personal Computer Guide to Operations. 
If there is a software problem, remain in this 
appendix. It contains information to help you 
isolate the following kinds of problems: 

@® Autokey 

— Record 

— Play 

— Erase 

Communication 

Customization 

File transfer 

Keyboard 

IBM 3270 Personal Computer printer 
Notepad 


Patch 


Personal computer application under the control 
program 


Save and Restore 
System startup 


Trace 


Solving IBM 3270 Personal Computer Problems B-3 


B-4 


® Work station control mode 

— Browse 

— Copy 

— Help 

— List 

— Setup. 
The ‘“‘homeplate’’ symbol will help you work 
through these procedures. It always has a num- 
ber inside it. When you see the homeplate and its 


number, look for the next homeplate that has the 
same number and continue. 


Problems That May Occur While 
You Are Using the IBM 3270 
Personal Computer 


How can you use this appendix? The following 
chart lists hardware and software problem 
symptoms and the actions needed to begin 
solving the problem. 


If you need to use the Dump facility for problem 
determination procedures and you have turned 
on the Trace option, turn Trace off with the 
dump option. If you have not turned on the 
Trace option, you may do one of the following: 


@ Press Alt + Ctrl + Test 
or 


@ If you have the red Non-Maskable Interrupt 
(NMI) button at the back of the system 
unit, press it. 


You are then prompted with the message: 


SY006 Do you want to take a dump? Data will 
be destroyed (Y/N) 


Reply ‘“‘Y’’ to take a dump, or ‘‘N”’ to re-IPL the 
system. If the keyboard does not respond and if 
you have an NMI button at the back of the sys- 
tem unit, Press the NMI button again to start 
the dump process. You are then prompted with 
messages that lead you through the dump proc- 
ess. During this process, you can respond to any 
message that requires a reply with either the 
requested key or the NMI button. When the 
dump has completed, you are prompted to insert 
the customized system diskette and to press any 
key to re-IPL the system. 
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If, while using your IBM 3270 Personal Com- 
puter with the control program loaded, the sys- 
tem appears to be working incorrectly or not 
working at all, always do the following first: 


Did you just set your system unit On/Off switch 
to On? 


No re 
Did you receive a Power-On Self Test 
(POST) error message when you powered 
on? (If you need more information about 
POST error messages, refer to the JBM 
3270 Personal Computer Guide to Opera- 
tions, Problem Determination section. 


No Yes 
| 
Refer to the Problem Determina- 
tion section of the IBM 3270 
Personal Computer Guide to 
Operations. 


Did you receive any CUnnn messages? 


No Yes 
| 


Refer to Customization Problem 
Determination, page B-63. 


Did you receive any SYnnn messages? 


No Yes 
| 
Refer to System Error Problem 
Determination, page B-98. 


Vv, 


Did you receive any other IBM 3270 Personal 
Computer messages? (STnnn, PATnn, SRnnn, 
TRnn, TRANSnn, WSnnn) 


No Yes 
| 
Refer to the message in Appendix E. 


Did the message aid in resolving the 


problem? 
No oe 
| ae with your work. 
Do you have a problem with a host session or 
window? 
No Yes 


Refer to Communication Problem 
Determination, page B-53. 


Record the conditions that exist. Refer to the 
IBM 8270 Personal Computer Guide to Opera- 
tions and run Problem Determination. 


Did the diagnostics isolate a hardware problem? 


No Yes 
| 
Follow your local procedures for getting 
the hardware repaired. 
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Do you have a problem in Work Station Control 


including Copy, Help, List, SetUp, and Browse? 


No Yes 
| 
Refer to Work Station Control Problem 
Determination, page B-119. 


Do you have a problem with Autokey? 


No Yes 
| 
Refer to Autokey Problem 
Determination, page B-11. 


Do you have a problem with notepad? 


No ad 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. A system level. To do this, look at 
your APAR list as described under 
“Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 

c. A print of the session. 
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Do you have a problem with the personal com- 
puter window or session? 


No Yes 
| 
Refer to Personal Computer Application/ 
Control Program Problem Determination, 
page B-94. 


Do you have a problem with Save/Restore? 


No Yes 
| 
Refer to Save and Restore Problem 
Determination, page B-96. 


Are you having problems transferring files? 
No Yes 
| 


Refer to File Transfer Problem 
Determination, page B-68. 


Are you having a problem with Patch? 


I 

Refer to Patch Problem Determination, 
page B-91. 

Are you having a problem using the printer? 


No Yes 


| 3 | 
| Refer to IBM 3270 Personal Computer 
Printer Problem Determination, page B-86. 
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Are you having a problem with Trace? 


I 

Refer to Trace Problem Determination, 
page B-118. 

Are you having a problem with the keyboard? 


No Yes 
| 
Refer to Keyboard Problem 
Determination, page B-80. 


Are you having problems not previously 
covered? 


No a 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the problem, including the keys 
pressed and in what order. 

b. A system level. To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 


Continue with your work. 


Autokey Problem Determination 


Are you in work station control mode (check the 
operator information area)? 


Yes No 


You must be in work station control 
mode to activate Autokey. 


Press WS Ctrl. 


Is WSCTRL in the operator information 
area? 


Yes No 


1. Reproduce the operation 

while running Trace event 1. 
2. Turn Trace off with the 

dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including keys pressed 
and in what order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs’”’ in Appendix C. 
The dump. 
Configuration data sets. 
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Does the operator information area indicate 


Make sure you are in lowercase. 
Press Auto. 


Does the operator information area indi- 


Autokey? 
Yes No 
: 
2. 
| 
cate Auto? 
No 
Ff ; 
2: 
3. 


Reproduce the operation 
while running Trace event 1. 
Turn Trace off with the 
dump option. 

Follow your local procedures 
and have available: 


a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 

this, look at your APAR 

list as described under 

“Listing the Current 

System Level and 

Currently Installed 

APARs” in Appendix C. 

The dump. 

Configuration data set. 


ao 


Is the problem with Recording? 


Yes No 
| 
Refer to Autokey Problem Determina- 
tion: Play or Autokey Problem Determi- 
nation: Erase. 


Does the operator information area indicate 
Record? 


Yes No 
| 
Press the Record key. 
| 


Does the operator information area indi- 
cate Record? 


Yes No 


1. Reproduce the operation 

while running Trace event 1. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
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Cc. 


d. 


“Listing the Current 
System Level and 
Currently Installed 
APARs’” in Appendix C. 
The dump. 
Configuration data sets. 


Does List appear on the right side of the screen? 


No Yes 


Press PF1 (List). 


Did List disappear? 


1. Reproduce the operation 
while running Trace event 1. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 


a. 


a0 


The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

A system level. To do 
this, look at your APAR 
list as decribed under 
“Listing the Current 
System Level and 
Currently Installed 
APARs’”’ in Appendix C. 
The dump. 
Configuration data sets. 


Retry the Record operation. 
| 


Was it successful? 


| 
| Continue with your work. 


1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 

at your APAR list as described 
in under ‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 
The dump. 

Configuration data sets. 


2.9 


Is there an error message in the operator infor- 
mation area? 


Yes No 
| 
1. Reproduce the operation while 
running Trace event 1. 
2. Turn Trace off with the dump 
option. 
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3. Follow your procedures and have 
available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Is there space remaining in the message record- 
ing space? 


No Yes 
| 
Press PF 1 (List). 


Is free space less than 14? 


No Yes 
| 
The space is full. You must 
delete a recording if you want 
to make room for a new one. 


The recording area has been damaged. 
1. Reproduce the operation while run- 
ning Trace events 1, 4, 5, and 6. 


2. Turn Trace off with the dump 
option. 
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3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


4. Recover by using the Restore of a 
previous autokey file. 


Does the message indicate you cannot record 
because another recording is in progress? 


No Yes 
| 
Select Screen Profile 0 and jump through 
all windows, looking for a recording indi- 
cation in the operator information area. 


Did you find the recording indicator? 


No Yes 
| | 
Only one recording can be active 
at a time. Finish the first before 
trying to start another. 


1. Reproduce the operation while run- 
ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 


See 
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3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Is there a message on the screen that indicates 
you cannot record because the window is cur- 
rently busy? 


No Yes 
| 


Wait until the window is no longer busy 
and retry the operation. 


Is there a message on the screen that indicates 
you pressed an invalid key? 


No Yes 
| 


Does Play appear in the operator infor- 
mation area? 


No Yes 
| 
Play is already in progress with 
the active window and must be 
completed before a recording can 
be started. 
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1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Are you having a problem entering the recording 
name? 


No Yes 
| 


Does the recording name consist of only 
letters and/or numbers? 


Yes No 
| 
Recording names must be letters 
and/or numbers. 


Correct and retry. 
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Is List on the screen? 
No Yes 


Press PF 1 (List) and retry the 
operation. 


1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 
3. Follow your local procedures and 

have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under “Listing the Current 
System Level and Currently In- 
stalled APARs’”’ in Appendix C. 


c. The dump. 

d. Configuration data sets. 
Does an error message appear when Enter is 
pressed? 
No Yes 


Is there a ‘‘Duplicate name entered’”’ 
message on your screen? 


No Yes 
| 
Press PF 1 (List). 


UA, 
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Poy 


Is there a name that is exactly 
the same? 


No Yes 
| 
Use a unique name or 
delete the old name and 
retry. 


1. Copy the directory entries. 
2. Restore the Autokey data 
set and retry. 


If it still fails: 


1. Reproduce the operation 
while running Trace events 

1, 4, 5, and 6. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs’” in Appendix C. 
The dump. 
Configuration data sets. 


Ae 
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<i 


Do you get a message that says an 
invalid name was entered? 


No 


Yes 

| 

Is the operator information area 
input field all blanks? 


No Yes 
| 
Blanks are invalid. Use a 
valid name and retry. 


1. Reproduce the operation 
while running Trace events 

1, 4, 5, and 6. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 
The dump. 
Configuration data sets. 
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When Enter is pressed, does the active applica- 
tion regain control of the screen and keyboard, 
and does the operator information area have an 
R, indicating recording? 


Yes No 


1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘“‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Are you trying to record a pause? 


No Yes 
| 


Does the Pause key turn the pause indi- 
cator on and off? 


Yes No 
| 


Does the operator information 
area state SCREEN = 0? 


No Yes 
| | 


Recording space is full. 
Delete a recording and 
retry. 
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1. Reproduce the operation 
while running Trace events 

1, 4, 5, and 6. 

2. Turn Trace off with the 
dump option. 
3. Follow your local procedures 

and have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what 
order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Are you trying to end a recording? 


No a 


Have you pressed Finish? 


Yes No 
| 
Press Finish to complete the 
recording and continue normal 
operation. 


Can you do normal typing from your 
keyboard? 


No Yes 


Continue normal operation. 
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1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. | 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Are you trying to cancel a recording? 
No Yes 

— you pressed Quit? 

Yes No 


| 
Press Quit. 


Did the R and the P in the operator 
information area disappear? 


Yes No 
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1. Reproduce the operation 
while running Trace events 
1, 4, 5, and 6. 
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Turn Trace off with the 
dump option. 

Follow your local procedures 
and have available: 


a. 


c. 
d. 


The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 
The dump. 
Configuration data sets. 


Can you do normal typing on the 


keyboard? 


No Yes 


Recording was canceled. 
Continue normal operation. 


1. Reproduce the operation while run- 
ning Trace events 1, 4, 5, and 6. 
2. Turn Trace off with the dump 


option. 


3. Follow your local procedures and 
have available: 
a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 


b. A system level. To do this, look 
at your APAR list as described 
under ‘“‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


If none of the above conditions exists, you are 


not using Autokey to record. Continue with your 
normal operation. 
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Autokey Problem Determina- 
tion: Play | 


Is the problem with Play of a recording? 


Yes No 
| 
If none of the conditions exist, you are 
not performing an Autokey Play opera- 
tion. Continue with your work. 


Does the operator information area indicate Play 
when the Play key is pressed? 


Yes No 
| 


Is List on the screen? 


No Yes 
| 
Press List (PF1). 


Did List disappear? 


Yes i 

1. Reproduce the opera- 
tion while running 
Trace event 1. . 

2. Turn Trace off with 
the dump option. 

3. Follow your local 
procedures and have 
available: 

a. The sequence of 
events that 
caused the fail- 
ure, including 
the keys pressed 


and in what 
SOeey m 


b. A system level. 
To do this, look 
at your APAR 
list as described 
under “Listing 
the Current Sys- 
tem Level and 
Currently In- 
stalled APARs’”’ 
in Appendix C. 
The dump. 
Configuration 
data sets. 
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Retry the operation. 


Is there an error message in the operator 
information area? 


Yes No 


| 
Refer to Work Station Control 
Problem Determination. 


Does the message indicate that you can- 
not play a recording at this time? 


No Yes 
| 
Wait until the window is 
not busy and retry the play 
operation. 


Is there an ‘“‘incorrect key pressed”’ 
message? 


No Yes 
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| Is Record or Play present in the 
right half of the operator infor- 
mation area? 


No res 


A recording or play ses- 
sion is already in progress 
with the active window. It 
must complete operation 
before a new play can 
begin. 


Retry after the previous 
operation is completed. 


1. Reproduce the operation while 

running Trace events 1, 4, 5, 

and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, in- 
cluding the keys pressed 
and in what order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current Sys- 
tem Level and Currently 
Installed APARs” in 
Appendix C. 


c. The dump. 
oat d. Configuration data sets. 
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Are you having a problem entering the recording 
name? 


No Yes 
| 
Does the recording name consist of 
letters and/or numbers? 


Yes No 
| 
Recording names must consist of 
letters and/or numbers. Correct 
and retry. 


Is List on the screen? 


No Yes 
| 
Press PF1 and retry the 
operation. 


1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 

at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 
The dump. 

Configuration data sets. 


2.0 
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Does an error message appear when the Enter 


key is pressed? 


No Yes 


Was an unknown recording name 
entered? 


No 


Yes 
| 
Display the list of recordings. 


Is the name entered an exact 
duplicate of one of the names in 
List, or a unique short portion of 
one of the names? 
| 
Yes No 
| 
Correct the name and 
retry the operation. 


1. Reproduce the operation 
while running Trace events 

1, 4, 5, and 6. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
‘“‘Listing the Current 


System Level and 
Currently Installed 
APARs’”’ in Appendix C. 


c. The dump. 
d. Configuration data sets. 


Does the message indicate an invalid 
name entered? 


No Yes 
| 
Is the operator information area 
input field all blanks? 


Blanks are invalid for an 
autokey name. Correct 
and retry the operation. 


1. Reproduce the operation 
while running Trace events 

1, 4, 5, and 6. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. | 

b. A system level. To do 
this, look at your APAR 
list as described under 
‘Listing the Current 
System Level and 
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Cc. 
d. 


Currently Installed 
APARs” in Appendix C. 
The dump. 
Configuration data sets. 


When the Enter key is pressed, does the 
active application regain control of the 
screen and is there a P in the operator 
information area? 


1. Reproduce the operation 
while running Trace events 
1, 4, 5, and 6. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 


a. 
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The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 
The dump. 
Configuration data sets. 


This is normal. Continue with your work. 


Does the Pause indicator appear in the operator 
information area when no Pause key was re- 
corded either by pressing the Pause key or by. 
pressing an attention key such as PAI, a PF 
key, or Enter? 


No Yes 
| 
The keystroke from the recording may 
be invalid for the current window. This 
condition may occur if you recorded key- 
strokes in one window and you attempted 
to play them in another window. Key- 
strokes might be rejected by the active 
application if you tried to keystroke into 
a protected field. Correct the condition 
that is causing the error and retry the 
operation. 


Does the Pause indicator toggle off when the 
Pause key is pressed? 


No Yes 
| 


This is normal. Continue with your work. 


Is the area you are trying to play into valid for 
input, that is, not a protected field? 


Yes No 
| 
Play can be only into areas that allow in- 
put. Correct the condition and retry the 
operation. 
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| 
Have you recorded pauses that you are not 
getting? 


No ea 
Pauses recorded after you press an atten- 
tion key such as PAI, a PF key, or Enter 
are ignored, since the attention key gen- 
erated its own pause. Pauses recorded as 
the last keystroke of a recording are also 
ignored. 


Is this your condition? 


No Yes 
| 
This is normal operation. Continue 
with your work. 


1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 

at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 
The dump. 

Configuration data sets. 
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Are you trying to cancel a play session? 


No Yes 
| 


Are you in application mode? 


Yes No 
| 
Press WS Ctrl, a toggle key, to 
get into application mode. 


Did the P in column 55 of the operator 
information area and the P, if on, in 
column 57 of the operator information 
area disappear when the Quit key was 
pressed? 


Yes No 


1. Reproduce the operation 
while running Trace events 

1, 4, 5, and 6. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. | 

b. A system level. To do 

this, look at your APAR 
list as described under 
‘‘Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 
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No Yes 


IRD SS 


c. The dump. 
d. Configuration data sets. 


Did normal keystroking continue and no 
unusual screen changes occur? 


Play was canceled correctly. Con- 
tinue with your work. 


Reproduce the opera- 
tion while running 
Trace events 1, 4, 5, 
and 6. 

Turn Trace off with 
the dump option. 
Follow your local 
procedures and have 
available: 


a. 


The sequence of 
events that 
caused the fail- 
ure, including 
the keys pressed 
and in what 
order. 

A system level. 
To do this, look 
at your APAR 
list as described 
under ‘‘Listing 
the Current Sys- 
tem Level and 
Currently In- 
stalled APARs”’ 
in Appendix C. 


YY YY 


c. The dump. 
d. Configuration 
data sets. 


If none of the above condition exists, you are not 


playing an autokey recording. Continue with 
your normal operation. 
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Autokey Problem Determina- 
tion: Erase 


Are you trying to erase a recording? 
Yes No 


If none of the conditions exist, you are 
not performing an autokey Erase opera- 
tion. Continue your work. 


Does the operator information area indicate 


WSCTRL? 
Yes No 
| 
Press the WS Ctrl key. 


Does the operator information area indi- 
cate WSCTRL? 


Yes > re) 
1. Reproduce the operation 

while running Trace event 1. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
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System Level and 
Currently Installed 
APARs’”’ in Appendix C. 
c. The dump. 
d. Configuration data sets. 
Does the operator information area indicate 
Auto? 


Yes No 
| 
Make sure you are in lowercase, and 
press the Auto key. 


Does the operator information area indi- 
cate Auto? 


Yes No 


1. Reproduce the operation 

while running Trace event 1. 

2. Turn Trace off with the 
dump option. 
3. Follow your local procedures 

and have available: . 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
‘Listing the Current 


Y 
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System Level and 
Currently Installed 
APARs’”’ in Appendix C. 
c. The dump. 
d. Configuration data sets. 


Does the operator information area indicate 
Erase? 


Yes No 
| 
Press the Erase Input (ErInp) key. 


Does the operator information area indi- 
cate Erase? 


Yes No 


| 
Is List on the right side of the 
screen? 


No Yes 
| 
Press PF 1 (List). 
| 
Did List disappear? 
Yes No 
1. Reproduce the opera- 
tion while running 
Trace event 1. 


2. Turn Trace off with 
the dump option. 
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NIN? 


Follow your local 
procedures and have 
available: 

a. The sequence of 
events that 
caused the fail- 
ure, including 
the keys pressed 
and in what 
order. 

b. A system level. 

To do this, look 

at your APAR 

list as described 
under ‘‘Listing 
the Current Sys- 
tem Level and 

Currently In- 

stalled APARs’”’ 

in Appendix C. 

The dump. 

Configuration 

data sets. 


p.0 


Does the operator information 
area indicate Erase? 


No Yes 
| 
Retry the erase 
operation. 


Press the Erase key. 
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Does the operator information 
area indicate Erase? 


No 


Yes 


Retry the erase 
operation. 


Reproduce the operation 
while running Trace event 1. 
Turn Trace off with the 
dump option. 

Follow your local procedures 
and have available: 


a. 


n° 


The sequence of events 
that caused the failure, 
including the keys 
pressed and in what or- 
der: 

A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs’”’ in Appendix C. 
The dump. 
Configuration data sets. 


Is there an error message in the operator 
information area? 


Yes No 


Reproduce the operation 
while running Trace event 1. 
Turn Trace off with the 
dump option. 


3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
‘‘Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Does the message indicate that you can- 
not erase or delete a recording, because 
record or play is in progress? 


No Yes 
| 
Select Screen Profile 0 and jump 
through all available windows, 
looking for a recording or play 
indicator in the operator informa- 
tion area. 


Did you find a recording or play 

indicator on? 

| | 

No Yes 
| 
This is normal operation. 
Retry the Erase after the 
recording or play com- 
pletes operation. 


ONY 
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1. Reproduce the operation while run- 

ning trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing and Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Are you having a problem entering the recording 


name? 

No Yes 
. the recording name only letters or 
numbers? 
Yes No 


Recording names must be only 
letters or numbers. Correct and 
retry. 


Is List on the screen? 
No Yes 


Press PF1 and retry the 
operation. 
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1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs’”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Does an error message appear when the Enter 
key is pressed? 


No Yes 
| 


Was the message text “Unknown name 
entered’’? 


No Yes 
| 
Display the list of recordings. 


Is the name entered an exact du- 
plicate of one of the names in the 
list, or a unique short portion of 
the names? 


Yes No 
| 


Correct the name and 
ie retry the operation. 
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Reproduce the operation 
while running Trace events 
1, 4, 5, and 6. 

Turn Trace off with the 
dump option. 

Follow your local procedures 
and have available: 


a. 


c. 
d. 


The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

A system level. To do 
this, look at your APAR 
list as described under 
‘Listing the Current 
System Level and 
Currently Installed 
APARs’”’ in Appendix C. 
The dump. 
Configuration data sets. 


Does the message indicate an invalid 


name entered? 


No Yes 


Is the operator information area 
all blanks? 


No 


Yes 


Blanks are invalid for an 
autokey name. Correct 
and retry the operation. 


1. Reproduce the operation 
while running Trace events 

1, 4, 5, and 6. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 

that caused the failure, 
including the keys 
pressed and in what 
order. 

b. <A system level. To do 
this, look at your APAR 
list as described under 
‘Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 

c. The dump. 

d. Configuration data sets. 


When the Enter key is pressed, do you 
remain in work station control mode and 
does the prompt line ask for the opera- 
tion to be performed? 


Yes . fe) 
1. Reproduce the operation 
while running Trace events 
1, 4, 5, and 6. 
2. Turn Trace off with the 
dump option. 


OY 
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3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Is the erased recording still available for use? 
No Yes 


1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 

at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 
The dump. 

Configuration data sets. 


2.9 
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Are you trying to cancel an erase operation? 


No Yes 
| 
Did you press the Quit key before press- 
ing Enter? 


Yes No 
| 
The recording has been erased. 
Recovery would be to restore the 
autokey file if the recording was 
saved. 


Does the operator information area re- 
vert to the initial autokey entry? 


No Yes 
| 
The erase has been canceled. 
Continue with your normal work. 


1. Reproduce the operation while run- 

ning Trace events 1, 4, 5, and 6. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs” in Appendix C. 


WY 
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c. The dump. 
d. Configuration data sets. 


If none of the above conditions exists, you are 
not performing an autokey erase or play opera- 
tion. Continue with your normal work. 


Communication Problem 
Determination 


1. Match your symptom with one in the follow- 
ing chart, and take the action specified. 


2. If ahardware failure is indicated, refer to 
IBM 8270 Personal Computer Guide to 
Operation for verification. 


3. If you find a hardware problem, follow local 
procedures for reporting IBM 3270 hard- 
ware failures. 


4. If you find no hardware problem: 


a. Reproduce the problem while running 
Trace events 16 through 30. 


b. Stop Trace with the dump option. 


c. Report the failure to your support per- 
sonnel with the following information: 


1) The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 


2) A print of the screen after the fail- 
ure occurs. 


3) A system level. To do this, look at 
your APAR list as described under 
“Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 


4) A dump. 


5) The type of host (VM/CMS, TSO, 
etc.) 


6) Configuration data sets. 


Note: n = number from 0 to 9. 
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Symptom 


3274 Control Unit The LT is not customized 
on the 3274. Follow local 
procedures for reporting 
3274 problems. 


3274 Control Unit The 3274 is not active or 
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Blank screen 
with no {4] in 
the operator in- 
formation area 


Note: The oper- 
ator information 
area may or may 
not contain other 
errors. 


Blank screen 
with [4] in the 
operator infor- 
mation area and 
no other errors 
in the operator 
information 
area. 


3270 Persona! Com- 
puter hardware 


Bad connection 
between 3274 and 
the 3270 Personal 
Computer 


3270 Personal 
Computer 


3270 Personal Com- 


puter hardware 


3270 Personal 
Computer 


3270 Personal 
Computer 


responding: 


a. 


Refer to step 2, p. B-53 
and if the IBM 3270 
diagnostics do not indi- 
cate a hardware prob- 
lem follow local 
procedures for report- 
ing 3274 problems. 


Time is required for the 
system to perform a func- 
tion. WAIT. 


Refer to [BM 3270 Per- 
sonal Computer Guide 
to Operations. 


Follow the procedures 
for reporting 
problems. 


Refer to 4, steps a-c, 
p. B-53. 


There is no host appli- 
cation active for this 
logical terminal, Fol- 
low the procedures for 
reporting host 
problems. 


There is a customiza- 
tion mismatch (SNA 
vs. non-SNA) between 
the IBM 3270 Personal 
Computer and the 
3274. 


Turn power off and 
then on again. 


See step 3, p. B-53. 


x ®& 209 3270 Personal 
Computer 


1. Make sure the signal 
cable is connected. 


Turn power off and 
then on again. 


If the problem still 
exists, refer to the JBM 
3270 Personal Com- 
puter Guide to 
Operations. 


3270 Personal . Turn power off and 
Computer then on again for the 
host session. 


If the problem still ex- 
ists, see step 4, p. B-53. 


3274 Control Unit Turn power off and 
Unit then on again. 


2nn 


(not listed above) 


*® ®& 3nn 


If the problem still ex- 
ists, follow local proce- 
dures for reporting 

3274 problems. 


1. Press Reset and retry 
the operation. 


M FROG4nn | 3274 Control Unit 


If the problem still ex- 
ists, follow your local 
procedures for report- 
ing host problems. 


3274 Control Unit 


Press Reset and retry 
the operation. 


If the problem still ex- 
ists, follow your local 
procedures for report- 
ing 3274 problems. 


3270 Personal Com- 
puter 


Press Reset and retry 
the operation. 


If the indication cannot 
be reset, turn power 
off and then on again. 


See step 3, p. B-53. 
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3274 Control Unit 
Unit 


x & 630 


to 


x ® 640 


3270 Personal 


x & 650 


Press Reset and retry 
the operation. 


If the problem still ex- 
ists, follow the proce- 
dures for reporting 

3274 problems. 


When the problem is 
resolved, press Reset to 
continue. 


Turn power off, then 
on again, and retry the 
operation. 


If the problem still ex- 
ists, take a dump. 


Computer 
to 
x & 699 
M FRPOG?nn | Host 


3270 Personal 
Computer 


Any other 
problem 


3270 Personal 
Computer 


Press Reset and retry 
the operation. 


If the problem still ex- 
ists, follow your local 
procedures for report- 
ing host problems. 


Refer to the JBM 3270 
Personal Computer 
Guide to Operations. 


If the problem still ex- 
ists, see step 4, p. B-53. 

Se 
Time is required for the 
system to perform an 
internal function. 
WAIT. 


Program Error Codes 


The following is a list of error status codes dis- 
played by the IBM 3270 Personal Computer for 
the specified program checks. These codes are in 
two groups. The codes in the first group, 701 to 
730, signify an attachment-dependent error con- 
dition. The codes in the second group, 750 to 
772, signify an attachment-independent device 
error condition. For recovery in both groups, 
press the Reset key to reset the program check 
status and retry the operation. 


If the same problem still exists, follow local 
procedures. 


Effect 
(SNA Sense Code or 
Non-SNA Op Check) 


Action 


1. Press Reset and 
try again. 


RU >1,536 bytes received 
(SNA buffer overrun 
condition) 


2. Ifthe problem 
still exists, follow 


local procedures 
Function not supported: for reporting 
Unsupported Session problems. 
Control request 
Unsupported Data Flow 
Control request 
Invalid signal request code 


(for example, 0001X XXX) 


il aa 
not allowed 

ee 
[ros | Cnnngenor =i ee 
ee 
[roa | Daas [20m 
a 
ee 
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Effect 
Error (SNA Sense Code or 
Code | Probable Cause Non-SNA Op Check) | Action 


Session already bound 0815 1. Press Reset and 
try again. 
No LU-LU session 8005 
. If the problem 
7“ still exists, follow 


Not enough bytes in 0821 local p rocedures 
BIND RU for reporting 
problems. 
Invalid support level 0821 
(bytes 1-3) 
Invalid PLU protocol 0821 
(byte 4) 
Invalid SLU protocol 0821 
(byte 5) 
Invalid common protocol 0821 
(bytes 6—7) 
Less than 64-byte RU 0821 
length specified (byte 10) 
Invalid LU type (byte 14) 0821 
724 Invalid screen size 0821 
(bytes 20—24) 
Cryptography not sup- 
ported (byte 26) 
Negative SNA response 
from the host 
SNA exception request 
received 


An RM, RMA, or RB 
command or a Read Parti- 
tion SF type received with 
EB and/or without CD 


729 A Read Partition SF type 
received in retry state 


A Read buffer command 
received in normal state, 
and parition 0 does not 
exist. 


Invalid command received 1003 
Op Check 
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Probable Cause 


SFE, MF, or SA order with 
invalid character set value in 
the range X‘01’—X‘FE’ 


. Invalid address received 
following an SBA, RA 
or EUA order 

. MF order addressed to 
anonfield attribute 
location 


. Data follows aRM, 
RB, or EAU command 

. RA order received 
with invalid character 

. GE order received 
with invalid character 

. SFE, MF, or SA order 
with invalid attribute 
type 

. SFE, MF, or SA order 
with invalid attribute 
value for highlight or 
color or character set 
value of X‘FF’ 


Datastream ended before 
all required bytes for an 
RA, EUA, SF, SFE, MF, 
SA, or GE order were 
received 


a. Invalid order received 
(EBCDIC code value 
less than X‘40’ is not 
recognized) 

. EQs or sub control 
code received while 
3270 Personal Computer 
was configured for 
non-EAB 


. Invalid structured field 
type 

. Structured field type 
not supported for 
current configuration 
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Effect 
(SNA Sense Code or 
Non-SNA Op Check) 


0863 
Op Check 


1005 
Op Check 


1003 
Op Check 


1005 
Op Check 


1003 
Op Check 


1003 
Op Check 


Action 


1. Press Reset and 
try again. 


2. If the problem 
still exists, follow 
local procedures 
for reporting 
problems. 
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758 
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Probable Cause 


a. Load PS SF with invalid 

' PSalias 

b. Load PS SF load type 
not supported 


Effect 
(SNA Sense Code or 
Non-SNA Op Check) 


1003 
Op Check 


Set reply mode SF received 1003 
with invalid mode Op Check 


a. Read partition SF not 

last SF 

. SF type incomplete 

. SF length invalid 

. SF length 0000 but not 
last SF 

. Load PS SF length 
error 

. Set reply mode SF with 
field/ext. field mode and 
data following 


. Erase/Reset Area SF 
reserved fields not zero 

. Set Reply Mode SF 
attribute type reserved 


. SF type ID invalid, 
not created, or nonzero 
in implicit partition state 
b. Query PID not X‘FF’ 
. 3270 command received 
in explicit partition state 
and PID 0 does not exist 


. Create Partition SF 
parameter error 

. Set Window Origin SF 
parameter error. 


. Create Partition SF 
caused a window overlap 

. Create Partition SF 
rejected because of 
insufficient resources 


. Load PS SF addressed 
PS invalid 

. Load PS SF extension- 
invalid color bits 


1005 
Op Check 


1003 
Op Check 
1005 
Op Check 
1005 
Op Check 


1005 
Op Check 
084C 
Op Check 


1. Press Reset and 
try again. 


2. If the problem 
still exists, follow 
local procedures 
for reporting 
problems. 


Effect 
(SNA Sense Code or 
Probable Cause Non-SNA Op Check) 


765 a. Load PS SF with invalid 1005 
load start point Op Check 
. Load PS SF with invalid 
code point of X‘FF’ 
766 . Load PS SF with 1005 
incomplete PS cell data Op Check 
. Load PS SF with invalid 
end flag for type 2 PS 
. Load PS SF with invalid 
type 2 header (end flag 
not encountered and 
not end of data) 
767 . Create Partition SF with 1003 
invalid address mode Op Check 
. Create Partition SF 
with bits 0—3 of byte 4 
not zero 
768 Load PS SF extension: 1005 
a. Invalid x units Op Check 
b. Invalid y units 
c. Invalid extended 
parameter length 
d. Extended parameter 
length missing 
Load PS SF extension: 1003 
a. Invalid byte 8 Op Check 
b. Byte 11 not zero 
c. Byte 12 bits 5—7 not zero 
Structure field type (except 1001 
3270E) with start print in Op Check 
WCC, but not last structured 
field 


Reserved bits 3—7 not 
Invalid command in 1003 
structured field Op Check 


Action 


1. Press Reset and 
try again. 


2. If the problem 
still exists, follow 
local procedures 
for reporting 
problems. 


zero 
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Effect 
(SNA Sense Code or 
Probable Cause Non-SNA Op Check) | Action 


. Resources requested 084B 1. Press Reset and 
temporarily unavailable. Op Check try again. 
. Create Partition: 
1. No partition allocated . If the problem 
to the LT still exists, follow 
2. Number of partitions local procedures 
allocated to the LT for reporting 


exceeded problems. 
3. Scroll buffer specified 
but not allowed 
. Set Attribute, Modify 
Field, Start Field 
Extended: 
PSA-PSF requested, but 
PS not allocated to the LT 
. Load PS: 
PS not allocated to the 
LT 
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Customization Problem 
Determination 


Did you receive a customization message 
between CU001 and CU010 or between CU015 
and CU999? 


No Yes 
| 
Refer to the message in Appendix E and 
use the explanation and user response 
for resolving the problem. 


Did you receive message CU016? 


No Yes 
| 
Is the IBM 3270 Personal Computer 
Control Program loaded, or have you 
started a user application that reserves 
storage prior to doing customization? 


Yes No 
| 
Refer to the IBM 8270 Personal 
Computer Guide to Operations 
and run Problem Determination. 


Did the diagnostics find a hard- 
ware problem? 


Yes No 
| 
Do you have at least 
256K of storage? 


Yes No 


oe te oo Co 
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The IBM 3270 
Personal Com- 
puter requires 
at least 256K 
of storage to 
operate. 


Follow your local proce- 

dures and have available: 

a. The sequence of 
events that caused 
the failure. 

b. A copy of the 
system diskette. 


Follow your local procedures for 
reporting hardware problems. 


Retry the customization without loading 
the IBM 3270 Personal Computer Con- 
trol Program or the user application. 


Was customization successful? 


Yes No 
| 
Refer to the JBM 8270 Personal 
Computer Guide to Operations 
and run Problem Determination. 


Did the diagnostics find a hard- 
ware problem? 


Yes No 
| 


Follow your local proce- 
dures and have available: 


64 


B- 


2 The sequence of 
events that caused 
the failure. 

b. Acopy of the 
system diskette. 


Follow your local procedures for 
getting the hardware repaired. 


Continue customizing. 


Did you receive customization message CU011, 
CU012, CU013, or CU014? 


No Yes 
| 


Are you using the correct diskettes as 
input for the customization process? 


Yes No 


| 
Retry the operation with the 
correct diskette. 


Retry the operation with a backup of the 
diskettes. 


Does the failure persist? 


Yes No 
| 


Continue with your customiza- 
tion using the backup diskettes. 


Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 
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Did diagnostics find a hardware 
problem? 


Yes - re) 
Follow your local procedures and 
have available: 
a. The sequence of events that 
caused the failure. 
b. Acopy of the system 
diskette. 


Follow your local procedures for getting 
the hardware repaired. 


Did you receive message CU999? 


No 


Yes 

| 

Refer to the IBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did diagnostics find a hardware 
problem? 


Yes No 

| 

Follow your local procedures and 

have available: 

a. The sequence of events that 
caused the failure 

b. The error code reported in 
message CU0999 

c. Acopy of the system 
diskette. 


WIRY 


Follow your local procedures for getting 
the hardware repaired. 


Since you did not receive any customization mes- 


sages, refer to the beginning of the appendix and 
restart the problem determination process. 
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File Transfer Problem 
Determination 


Did you receive a TRANSnn message other than 
TRANS07, TRANSO8, TRANS11, TRANS13, 
TRANSI4, TRANS26, or TRANS27? 


No Yes 
| 
Refer to that message in Appendix E 
and follow the directions to correct the 
problem. 


Did you receive message TRANSO7? 


No Yes 
| 
Retry the operation. 


Did the problem persist? 


Yes No 
| 


Continue with your work. 
Is the host operational? 


Yes No 
| 
Retry the operation when the 
host is operating. 


1. Reproduce the operation while run- 
ning Trace events 45, 46, 47, and 48. 

2. Turn Trace off with the dump 
option. 
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3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
commands issued. 

b. The dump. 

c. A system level. To do this, look 
at your APAR list as described 
under “‘Listing the Current 
System Level and Currently In- 
stalled APARs’”’ in Appendix C. 


Did you receive message TRANS08? 


No Yes 
| 
Retry the operation. 


Did the problem persist? 


Yes No 
| 


Continue with your work. 
Is the host operational? 
Yes No 

| 


Retry the operation when the 
host is operating. 


1. Reproduce the operation while run- 
ning Trace events 45, 46, 47, and 48. 
2. Turn Trace off with the dump 


option. 
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3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
commands issued. 

b. The dump. 

c. A system level. To do this, look 
at your APAR list as described 
under ‘‘Listing the Current 
System Level and Currently In- 
stalled APARs”’ in Appendix C. 


Did you receive message TRANSI11? 


No Yes 
| 
Check the operator information area for 
the host session you are using file trans- 
fer with. 


Is there an error code in the operator 
information area? 


Yes No 


| 
Retry the operation. 


Was it successful? 
Yes No 


1. Reproduce the opera- 
tion while running 
Trace events 45, 46, 
47, and 48. 

2. Turn Trace off with 
the dump option. 
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3. Follow your local 
procedures and have 
available: 

a. The sequence of 
events that 
caused the fail- 
ure, including 
the commands 
issued. 

b. The dump. 

c. The system 
level. To do this, 
look at your 
APAR List as 
described under 
‘Listing the 
Current System 
Level and Cur- 
rently Installed 
APARs’”’ in 
Appendix C. 


Continue with your work. 


1. Reproduce the operation while run- 

ning Trace events 45, 46, 47, and 48. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
commands issued. 

b. The dump. 

c. The error code in the operator 


information area. 
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d. The system level. To do this, 
look at your APAR list as 
described under ‘‘Listing the 
Current System Level and Cur- 
rently Installed APARs”’ in Ap- 
pendix C. 


Did you receive message TRANS13? 


No - 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the Send 
command. 

b. Copy of the DOS file that caused the 
failure. 

c. A system level. To do this, look at 
your APAR list as described under 
‘‘Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 

d. Whether you are using VM/CMS or 
TSO. 


Did you receive message TRANS14? 


No a 
Follow your local procedures and have 
available: 
a. The sequence of events that caused 
this failure, including the Receive 
command. 


b. A hexadecimal dump of the host file 
that caused the error. 

c. A System level. To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 

d. Whether you are using VM/CMS or 
TSO. 


Did you receive message TRANS26? 
No Yes 


1. Reproduce the problem while run- 

ning Trace events 45, 46, 47, and 48. 

2. Turn Trace off with the dump 
option. 

3. Follow your local procedures and 
have available: 

a. The sequence of events that 
caused the failure, including the 
keys pressed and in what order. 

b. A dump of the failure. 

c. A system level (both host and 
personal computer). To do this, 
look at your APAR list as 
described under ‘‘Listing the 
Current System Level and 
Currently Installed APARs’”’ 
in Appendix C. 


Did you receive message TRANS27? 


No Yes 
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Did you press the Ctrl + Break keys? 
Yes No 


1. Reproduce the problem while 

running Trace events 45, 46, 

47, and 48. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that cause the failure, 
including the keys 
pressed and in what 
order. 

b. A dump. 

c. A system level (both 
host and personal com- 
puter). To do this, look 
at your APAR list as 
described under “‘List- 
ing the Current System 
Level and Currently 
Installed APARs”’ in 
Appendix C. 


This is normal message when file trans- 
fer is terminated by pressing the Ctrl + 
Break keys. 


Is the host inoperative? 
No Yes 
| 


Try the operation when the host is 
available. 
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Is the host file transfer program installed? 


Yes No 
| 
Report the condition in accordance with 
your local procedures. 


Was the file transfer command typed in the 
personal computer window? 


Yes No 
| 
Retry the operation, entering the com- 
mand in the personal computer window. 


Did file transfer complete operation without an 
error being reported, but there is a problem with 
the transferred file? 


No a 

If there is missing or incorrect data, 

but file transfer completes operation 

without indication of error, check for the 

following: 

a. It is a user error (bad source data 
set, incorrect options specified). 

b. User did not request APPEND 
(default is REPLACE). 

c. Ifthe host is TSO, there are poten- 
tial problems with user catalogs. 


If there is a host/incorrect data problem, 

follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
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OY 


pressed and in what order and 
including the file transfer command 
as it was entered. 

A hexadecimal dump of the host file. 
A copy of the personal computer file 
on diskette. . 

A system level (both host and per- 
sonal computer). To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 


Did file transfer terminate abnormally with an 
invalid error message, such as ‘‘File not found’’, 
when the file actually exists? 


No Yes 


Follow your local procedures and have 
available: 


a. 


The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

A system level. To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs’”’ in 
Appendix C. 

The diskette or a copy. 


SV, 


| 
Did file transfer hang? 


No ne 

Switch to the host session and verify you 

still have the host connection. If the 

hang is not due to the host being inoper- 
ative, follow your local procedures and 
have available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

A copy of the command issued. 

If the transfer was to disk or disk- 

ette, whether the failure is for all 

transfers or only for a specific (type/ 

size) file or data set. 

d. What other applications were 
running. 


a 


e 


Did you receive a program check at the host? 


No Yes 

| 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. A dump of the failure at the host 
end. 


Note: The personal computer must be 
powered down to recover. 
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| 
Did you receive a program check at the personal 
computer? 


No i 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. <A copy of the file being transferred. 


Did the personal computer send or receive too 
much ‘‘file’’ data or not the whole file? 


No we 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. Accopy of the host and personal 
computer files. 


Did you see “‘garbage’’ in the personal computer 
window rather than a message? 


No = 
Follow your local procedures and have 
available: 
a. The sequence of events that caused 
the failure, including the keys 
| pressed and in what order. 


ow 
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b. A system level. To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 


Did you see a user error message that contra- 
dicts the situation, such as “‘lost contact with 
host”’ but the host program is still running? 


No pee 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. A system level. To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 


You do not appear to have a problem with file 
transfer. Continue with your work. 
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Keyboard Problem 
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Can you keystroke in any window? 


Yes No 
| 
Turn power off and then on. Retry the 
operation. 


Do you have an error when you turn 
power on or are you unable to keystroke 
properly? 


No Yes 
| 
Refer to the IBM 8270 Personal 
Computer Guide to Operations. 


Is the personal computer window active 
(personal computer session)? 


Yes if O 


Is the problem with notepad window? 


No Yes 

| 

Follow your local procedures and 

have available: 

a. The sequence of events that 
caused the failure, including 
the keys pressed and in what 
order. 

b. The system level. To do this, 
look at your APAR list as 
described under ‘‘Listing the 
Current System Level and 
Currently Installed APARs’”’ 
in Appendix C. 


c. A print of the screen after 
the failure. 
Is the problem with the host window? 


No Yes 
Refer to Communication Problem 
Determination. 


Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics isolate a hardware 
problem? 


No Yes 
| 
Follow your local procedures for 
getting the hardware repaired. 


Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. A system level. To do this, look at 
your APAR list as described under 
‘Listing in the Current System 
Level and Currently Installed 
APARs’”’ in Appendix C. 
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Press WS Ctrl. 

Type A. 

Press Alt + Ctrl + Del. 
Release all keys. 

Press WS Ctrl. 


When you regain control, retry the opera- 
tion that failed. 


Sa 


Did this resolve the problem? 


No Yes 
| 


Continue with your work. 


Do incorrect characters or numbers appear on 
the screen as you are typing? 


No Yes 


| 
Press and release CapLk and retry the 
operation. 


Does the failure still occur? 
Yes No 
| 


Continue with your work. 


Press and release NumLk and retry the 
operation. 


Does the failure still occur? 


Yes No 


ne 


Continue with your work. 
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Press and release Insert and retry the 
operation. 


Does the failure still occur? 


Yes No 
| 


Continue with your work. 


| 
Press and release Pause and retry the 
operation. 


Does the failure still occur? 
Yes No 
| 


Continue with your work. 


Press and release Help and retry the 
operation. 


Does the failure still occur? 
Yes No 
| 


Continue with your work. 


Press and release List (PF 1) and retry 
the operation. 


Does the failure still occur? 
Yes No 


Continue with your work. 
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Refer to the IBM 8270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Does a function fail to execute when you press 
one of the following multiple-key combinations? 


Alt and/or Ctrl + Del 
Alt and/or Ctrl + NumLk 
Alt and/or Ctrl + Print 
Alt and/or Ctrl + Quit 
Alt and/or Ctrl + Attn 

+ 


Alt and/or Ctrl + Test 
Yes 


| 

Refer to the IBM 8270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics isolate a hardware 
problem? 


No Yes 
| 
Follow your local procedures for 
getting the keyboard repaired. 


Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. The system level. To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs” in 
Appendix C. 


Does the wrong function execute when you press 
keys for another function? 


No Yes 
| 
Refer to the JBM 8270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics isolate a hardware 
problem? 


No Yes 
| 
Follow your local procedures for 
getting the keyboard repaired. 


Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. The system level. To do this, look at 
your APAR list as described under 
“Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 


Are there other failures? 


No Yes 
| 
Refer to the IBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. This is a 
probable hardware problem. 


Continue with your work. 
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IBM 3270 Personal Computer 
Printer Problem Determination 


Did you receive a message indicating that the 
printer is not ready? 


No Yes 
| 
Ready the printer and retry. 


Note: If the printer has power off, is not 
attached, or is offline, or if there is no 
paper, an error condition will occur. 


Is the printer ‘‘on line’’ light now on? 


Yes i 
If the printer has power on and is 
cabled, but you cannot make it 
ready, refer to the IBM 38270 Per- 
sonal Computer Guide to Opera- 
tions for problem determination. 


Is the operation now successful? 


Yes No 
| 
Refer to the JBM 3270 Personal 
Computer Guide to Operations 
and run Problem Determination. 


Did the diagnostics find a hard- 
ware problem? 


Yes No 
| 
1. Reproduce the 
failure with Trace 
event 1. 


2. Stop Trace with the 
/d parameter and 
submit the dump. 

3. Follow your local 
procedures and have 
available: 

a. The sequence of 
events that 
caused the fail- 
ure, including 
the keys pressed 
and in what 
order. 

b. A description of 
the data on the 
screen. 

c. A system level. 
To do this, look 
at your APAR 
list as described 
under “Listing 
the Current Sys- 
tem Level and 
Currently In- 
stalled APARs”’ 
in Appendix C. 


Follow your local procedures for 
getting the failing unit repaired. 


Continue with normal operation. 


Did you press Print and nothing happened? 
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No Yes 


Refer to the IBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics find a hardware 


problem? 


Yes 


4. 


No 
| 

1 

2 

3 


Start Trace event 1. 

Press Print. 

Turn Trace off with the 
dump option. 

Follow your local procedures 
and have available: 


a. 


d. 


The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

A description of the 
data on the screen. 

A system level. To do 
this, look at your APAR 
list as described under 
‘Listing the Current 
System Level and 
Currently Installed 
APARs’” in Appendix C. 
The dump. 


Follow your local procedures for getting 
the failing unit repaired. 
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Does the print consist of invalid or incomplete 
data? 


No Yes 
| 
Refer to the [BM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics find a hardware 


problem? 
Yes No 
| 
1. Start Trace event 1. 
2 Press Print. 
3. Turn Trace off with the 


dump option. 

4. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A description of the 
data on the screen. 

c. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 

d. The dump. 


Follow your local procedures for getting 


the failing unit repaired. 
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Did the print complete operation and then the 
system hung? 


No ne 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. A description of the data on the 
screen. 

c. A system level. To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs’”’ in 
Appendix C. 


There does not appear to be a problem with 
Print. Continue with your work. 
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Patch Problem Determination 


Did you receive a Patch error message? 


No Yes 
| 
Follow the directions for the message in 
Appendix E to correct the problem. 


Did you follow the Patch installation procedures 
in Appendix C? 


Yes No 
| 
Correct your error and retry the 
operation. 


Did you receive the ‘‘PAT26 Patches Installed”’ 
message? 


Yes in O 

Follow your local procedures and have 

available: 

1. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

2. A backup copy on diskette of the 
diskette you patched. Include the 
patch file. 

3. The history file, printed with the 
print-screen utility. To do this, look 
at your APAR history list as 
described under “‘Listing the 
Current System Level and Currently 
Installed APARs”’ in Appendix C. 

4. A copy of the customization panels, 


| using the print-screen facility. 
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Notes: 

1. You can safely delete any user appli- 
cations from the backup diskette 
you are creating. . 

2. If step 3 cannot be done, because of 
the failure, describe the data on the 
screen, including the operator infor- 
mation area. 


Does the original problem still exist? 


Yes 


No 
| 


Do you have a new problem? 


Yes No 
| 


Continue with your work. 


Remove the Patch that appears to have 
caused the new problem. 


Does the problem still occur with the 
Patch removed? _ 


Yes i O 

Follow your local procedures and 

have available: 

a. The APAR number of the 
Patch causing the problem. 

b. A copy of the Patch file. 

c. The sequence of events that 
caused the failure, including 
the keys pressed and in what 
order. . | 


a 


Refer to the beginning of this appendix 
and restart the problem determination 
process. 


Note the APAR number that was to have fixed 
the problem and refer to the beginning of this 
appendix and restart the problem determination 
process. 
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Personal Computer Application/ 
Control Program 
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Problem Determination 


Refer to the JBM 3270 Personal Computer Guide 
to Operations and run Problem Determination. 


Did the diagnostics find a hardware problem? 


Yes No 
| 


Does the personal computer application 
work with DOS alone? 


Yes 


No 

| 

The problem is with the personal 
computer application. Report the 
problem to point of purchase. 


Follow your local procedures and have 
available: 


a. 


The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 
Problem description. 

Name of application (if purchased 
and copyrighted), or else a copy of 
the application. 

Data needed to run the application. 
The system configuration. (See 
‘‘Save and Restore Problem Deter- 
mination”’ for how to find out the 
configuration.) 


IY 


Note: It is possible that the application 
functions in a manner that prevents its 
use on a system with the IBM 3270 Per- 
sonal Computer Control Program, for 
example, if the application bypasses the 
normal DOS 2.0 or BIOS interfaces. 


Follow your local procedures for getting hard- 
ware repaired. 
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Save and Restore Problem 
Determination 
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Did you receive a Save or Restore error 
message? 


No Yes 
| 
Refer to Appendix E for help in deter- 
mining the cause of the failure. 


Did the problem persist? 


Yes No 
| 
Continue with your normal 
operation. 


If you restored data and the restored data 
was different from what you expected, did you 
specify the correct options? 


Yes No 
| 


Specify the correct options and retry. 


Refer to the JBM 3270 Personal Computer Guide 
to Operations and run Problem Determination. 


Did diagnostics find a hardware problem? 


Yes 7 O 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 
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b. A system level. To do this, look at 
your APAR list as described under 
“Listing the Current System Level 
and Currently Installed APARs’”’ in 
Appendix C. 

c. A print of the screen after the fail- 
ure occurs. | 

d. IfaSave or Restore command was 
entered and some of the data was 
saved (written to a file), all files 
associated with the command. 


Follow your local procedures for getting the 
hardware repaired. 
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System Error Problem 
Determination 
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Did you receive message SY001? 


No Yes 
| 


Was the message followed by SY006? 


Yes 


No 

| 

Refer to the IBM 3270 Personal 
Computer Guide to Operations 
and run Problem Determination. 


Did the diagnostics find a hard- 
ware problem? 


Yes . 0) 

Follow your local proce- 

dures and have available: 

a. The sequence of 
events that caused 
the failure, including 
the keys pressed and 
in what order. 

b. The system level. 
To do this, look at 
your APAR list as 
described under 
‘Listing the Current 
System Level and 
Currently Installed 
APARs” in Appen- 
dix C. 

c. The variable data in 
the message SYOO1. 


Follow your local procedures for 
getting the hardware repaired. 
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Did you reply Y for yes in response to 
the message to take a dump? 


Yes No 
| 
The system must be powered off 
and on at this point. 


Did you receive message SY007? 
Yes No 


| 

Refer to the IBM 38270 Personal 
Computer Guide to Operations 
and run Problem Determination. 


Did the diagnostics find a hard- 
ware problem? 


Yes . O 

Follow your local proce- 

dures and have available: 

a. The sequence of 
events that caused 
the failure, including 
the keys pressed and 
in what order. 

b. The system level. 
To do this, look at 
your APAR list as 
described under 
“Listing the Current 
System Level and 
Currently Installed 


Vee V mw, 
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Follow your local procedures for 
getting the hardware repaired. 


APARs’” in Appen- 

| dix C. 
| c. The variable data in 
the SY001 message. 


Did you receive message SY015? 


Yes No 


| ‘ 

Refer to the IBM 8270 Personal 
Computer Guide to Operations 
and run Problem Determination. 


Did the diagnostics find a hard- 
ware problem? 


Yes No 


Follow your local proce- 

dures and have available: 

a. The sequence of 
events that caused ~ 
the failure, including 
the keys pressed and 
in what order. 

b. The system level. 
To do this, look at 
your APAR list as 
described under 
‘Listing the Current 


ae oe 
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System Level and 
Currently Installed 
APARs” in Appen- 
dix C. 

c. The variable data in 
the SYO0O1 message. 


Follow your local procedures for 
getting the hardware repaired. 


Did the SY016 message indicate a failure 
in formatting? 


Yes No 


Did you receive message 


SY011? 


Yes . oO 
Refer to the JBM 8270 
Personal Computer 
Guide to Operations 
and run Problem 
Determination. 


Did the diagnostics find 
a hardware problem? 


Yes No 
| 
Follow your local 
procedures and 
have available: 
a. The sequence of 
events that 


lolol ly 
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| 

caused the fail- 
ure, including 
the keys pressed 
and in what 
order. 

b. The system 
level. To do this, 
look at your 
APAR list as 
described under 
‘Listing the 
Current System 
Level and Cur- 
rently Installed 
APARs’” in 
Appendix C. 

c. The variable 
data in the 
SYO0O1 message. 


Follow your local proce- 
dures for getting the 
hardware repaired. 


Did the SY013 message indicate 
a failure in dumping? 


Yes 


ROIS 
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a 

Refer to the JBM 8270 
Personal Computer 
Guide to Operations 
and run Problem 
Determination. 


VON 


Did the diagnostics find 
a hardware problem? 


Yes "e 

Follow your local 

procedures and 

have available: 

a. The sequence 
of events 
that caused 
the failure, 
including the 
keys pressed 
and in what 
order. 

b. The system 
level. To do 
this, look at 
your APAR 
list as de- 
scribed un- 
der ‘‘Listing 
the Current 
System 
Level and 
Currently 
Installed 
APARs”’ in 
Appendix C. 

c. The variable 
data in 
the SY001 
message. 

d. The dump. 


Follow your local proce- 


dures for getting the 
hardware repaired. 


VII 
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Was a retry of the dump by 
pressing Y successful? 


Yes 


No 
| 


Refer to the JBM 3270 
Personal Computer 
Guide to Operations 
and run Problem 
Determination. 


Did the diagnostics find 
a hardware problem? 


Yes 


No 


Follow your local 
procedures and 
have available: 


a. 


The sequence 
of events 
that caused 
the failure, 
including the 
keys pressed 
and in what 
order. 

The system 
level. To do 
this, look at 
your APAR 
list as de- 
scribed un- 
der ‘‘Listing 
the Current 


OOO’ 


B-104 


OOS, 


System 
Level and 
Currently 
Installed 
APARs’”’ in 
Appendix C. 
c. The variable 
data in 
the SY001 
message. 


Follow your local 
procedures for 
getting the hard- 
ware repaired. 


Refer to the IBM 3270 
Personal Computer 
Guide to Operations 
and run Problem 
Determination. 


Did the diagnostics find 
a hardware problem? 


Yes ‘ fe) 
Follow your local 
procedures and 
have available: 
a. The sequence 
of events 
that caused 


Solving IBM 3270 Personal Computer Problems B-105 


a ee 


B-106 


d. 


the failure, 
including the 
keys pressed 
and in what 
order. 

The system 
level. To do 
this, look at 
your APAR 
list as de- 
scribed un- 
der ‘‘Listing 
the Current 
System 
Level and 
Currently 
Installed 
APARs’”’ in 
Appendix C. 
The variable 
data in 

the SYO01 
message. 
The dump. 


Follow your local proce- 
dures for getting the 
hardware repaired. 


Retry the operations with 


another diskette. 
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Was the format successful? 


Yes 
Refer to the IBM 8270 
Personal Computer 
Guide to Operations 
and run Problem 
Determination. 


Did the diagnostics find a hard- 
ware problem? 


Yes hi 3) 

Follow your local proce- 

dures and have available: 

a. The sequence of 
events that caused 
the failure, including 
the keys pressed and 
in what order. 

b. The system level. 
To do this, look at 
your APAR list as 
described under 
‘Listing the Current 
System Level and 
Currently Installed 
APARs’”’ in Appen- 
dix C. 

c. The variable data in 
the SY001 message. 


Follow your local procedures for 
getting the hardware repaired. 


108b 
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Continue with the dump process. 


Did you receive message SY002? 


No Yes 
| . 
Were the first four characters of the 
variable data in the message between 


600 and 697? 


Yes ne 

Follow your local procedures and 

have available: 

a. The sequence of events that 
caused the failure, including 
the keys pressed and in what 
order. 

b. The system level. To do this, 
look at your APAR list as 
described under ‘“‘Listing the 
Current System Level and 
Currently Installed APARs’”’ 
in Appendix C. 

c. The variable data from the 
SY002 message. 


Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 
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Did the diagnostics find a hardware 
problem? 


_ Yes ta 

Follow your local procedures and 

have available: 

a. The sequence of events that 
caused the failure, including 
the keys pressed and in what 
order. 

b. The system level. To do this, 
look at your APAR list as 
described under ‘Listing the 
Current System Level and 
Currently Installed APARs’’ 
in Appendix C. 

c. The variable data from the 
SY002 message. 


Follow your local procedures for getting 
the hardware repaired. 


Did you receive message SY003? 


No Yes 
| 
Were the first four characters of the 


variable data in the message between 
600 and 697? 


Yes No 
| 
Follow your local procedures and 
have available: 
a. The sequence of events that 
reused the failure, including 
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the keys pressed and in what 
order. 

The system level. To do this, 
look at your APAR list as 
described under ‘‘Listing the 
Current System Level and 
Currently Installed APARs’”’ 
in Appendix C. 

The variable data from the 
SY003 message. 


Refer to the IBM 3270 Personal 
Computer Guide to Operations 
and run Problem Determination. 


Did the diagnostics isolate a hardware 


problem? 


Yes No 
| 


Note: Errors between 600 and 
697 indicate hardware errors and 
message SY003 indicates inter- 
mittent errors. If the problem 
persists and diagnostics fail to 
find the problem, follow local 
procedures and have available: 


a. 
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The sequence of events that 
caused the failure, including 
the keys pressed and in what 
order. 

The system level. To do this, 
look at your APAR list as 
described under ‘‘Listing the 
Current System Level and 
Currently Installed APARs”’ 
in Appendix C. 


Follow your local procedures for getting 
the hardware repaired. 


c. The variable data from the 
SY003 message. 


Did you receive message SY004? 
No Yes 


| 

Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Yes : oO 

Follow your local procedures and 

have available: 

a. The sequence of events that 
caused the failure, including 
the keys pressed and in what 
order. 

b. The system level. To do this, 
look at your APAR list as 
decribed under ‘‘Listing the 
Current System Level and 
Currently Installed APARs’’ 
in Appendix C. 

c. The variable data from the 
SY004 message. 


Follow your local procedures for getting 
the hardware repaired. 


VY 
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Did you receive message SY005? 


No Yes 
| 


Is the message persistent? 


Yes No 
| 


Continue with your work. 


Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did diagnostics isolate a hardware 
problem? 


Yes Ne 

Follow your local procedures and 

have available: 

a. The sequence of events that 
caused the failure, including 
the keys pressed and in what 
order. 

b. The system level. To do this, 
look at your APAR list as 
described under ‘‘Listing the 
Current System Level and 
Currently Installed APARs’”’ 
in Appendix C. 

c. The variable data from the 
SY005 message. 


Follow your local procedures for getting 
the hardware repaired. 


Since you received no SYnnn messages, go to the 
start of this appendix and restart the problem 
determination process. 
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System Startup Problem 
Determination 


If you received a System Startup message 
between ST001 and ST007 and have not yet 
referred to Appendix E, (Startup Messages: 
STnnn), do so before continuing in this appendix. 


Did you receive message STO001? 


No Yes 
| 
Refer to the IBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics find a hardware 
failure? 


Yes : oO 
Follow your local procedures and 
have available: 
a. The sequence of events that 
caused the failure. 
b. A copy of the system 
diskette. 


Follow your local procedures for getting 
the hardware repaired. 


Did you receive ST002 or ST007? 
No Yes 


Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure. 

b. Acopy of the system diskette. 


c. The file name in message STO002 or 
stb 
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Did you receive message ST003? 


No Yes 
| 
Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics find a hardware 
problem? 


Yes No 

| 

Follow your local procedures and 

have available: 

a. The sequence of events that 
caused the failure. 

b. A copy of the system 
diskette. 

c. The file name in message 
ST003. 


Did you receive messsage ST004? 


No Yes 
| 
Have you started a user application that 
reserves storage prior to doing startup? 


Yes No 
| 
Refer to the JBM 3270 Personal 
Computer Guide to Operations 
and run Problem Determination. 
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Did the diagnostics find a hard- 
ware failure? 


Yes : 0) 

Follow your local proce- 

dures and have available: 

a. The sequence of 
events that caused 
the failure. 

b. A copy of the 
system diskette. 


Follow your local procedures for 
getting the hardware repaired. 


Retry the startup operation without 
loading the user application. 


Was startup successful? 


Yes No 
| 


Power off and on. 
Was the POST successful? 


Yes No 
| 
Refer to the IBM 8270 Personal 
Computer Guide to Operations 
and follow your local procedures 
for getting the hardware 
repaired. 


Refer to the IBM 3270 Personal 
Computer Guide to Operations and 


run Problem Determination. 
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Did the diagnostics find a hardware 
problem? 


Yes ha 
Follow your local procedures and 
have available: 
a. The sequence of events that 
caused the failure. 
b. A copy of the system 
diskette. 


Follow your local procedures for getting 
the hardware repaired. 


More storage will be required if both the 
user application and the IBM 3270 
Personal Computer Control Program are 
required at the same time. 


Did you receive message ST005? 


No 


re 

The file name specified in the message 
did not contain expected data. Either the 
file has been damaged or it is not an 
IBM file. If the file is an IBM file, re- 
place the system diskette with a backup 
system diskette, or repeat the customiza- 
tion task and retry the startup. 


Was the operation successful? 


Yes No 
| 
Follow your local procedures and 
have available: 


a. The sequence of events that 
caused the failure. 

b. A-copy of the system 
diskette. 

c. The file name in message 
STO05. 


Continue with your work. 
You received message STO006. 
File INDCXFL.DAT contains invalid data. 
Follow local procedures and have available: 
a. The sequence of events that caused the 


failure. 
b. Acopy of the INDCXFL.DAT file. 
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Trace Problem Determination 
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Are there any TRnn messages that indicate the 
cause of the failure? 


No Yes 
| 
Does the message indicate a procedural 
error? 


No Yes 
| 


Correct the problem and retry. 
Is the problem resolved? 


No Yes 
| 


Continue with normal operation. 


Refer to the IBM 8270 Personal Computer Guide 
to Operations and run Problem Determination. 


Did the diagnostics find a hardware problem? 


Yes No 

| 

Follow your local procedures and have 

available: 

a. The sequence of events that caused 
the failure, including the keys 
pressed and in what order. 

b. The exact Trace command entered. 

A system level. To do this, look at 
your APAR list as described under 
‘Listing the Current System Level 
and Currently Installed APARs”’ in 
Appendix C. 


© 


Follow your local procedures for getting the 
hardware repaired. 


Work Station Control Problem 
Determination 


Did you receive a WSnnn message? 


No Yes 
| 


Refer to Work Station Control messages 
(WSnnn) in Appendix E and follow the 
directions to correct the problem. 


Is the problem with Auto? 


No Yes 
| 
Refer to Auto Key Problem 
Determination. 


Is the problem with Copy? 


No nee 


Are there any WSnnn message that indi- 
cate a Copy problem? 


No Yes 


Does the message indicate a 
procedural error? 


No Yes 
| 
Correct the error and 
retry. 


Is the problem resolved? 


No Yes 
| 


Continue with your work. 
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Wee 


Refer to the IBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics find a hardware 


problem? 

Yes No 
‘ ‘ 
Z 
3. 


Reproduce the operation 
while running Trace event 1. 
Turn Trace off with the 
dump option. 

Follow your local procedures 
and have available: 


a. 


Cc. 
d. 


The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs” in Appendix C. 
The dump. 
Configuration data sets. 


Follow your local procedures for getting 
the hardware repaired. 


Is the problem with Help or List? 


A, 


Are there any messages that indicate the 
cause of the failure? 


No Yes 
| 
Does the message indicate a 
procedural error? 


No Yes 
| 
Correct the error and 
retry. 


Is the problem resolved? 


No Yes 
| 


Continue with your work. 


Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics find a hardware 
problem? 


Yes No 


1. Reproduce the operation 
while running Trace event 1. 
2. Turn Trace off with the 
dump option. 
3. Follow your local procedures 
and have available: 
a. The sequence of events 
that caused the failure, 
including the keys 


pressed and in what 
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b. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs’”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Follow your local procedures for getting 
the hardware repaired. 


Is the problem with SetUp? 


No Yes 
| 
Are there any messages that indicate the 
cause of the failure? 


No Yes 
Does the message indicate a 
procedural error? 


No Yes 
| 
Correct the error and 
retry. 


Is the problem resolved? 
No Yes 
| 


Continue with your work. 


ONY 


Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics find a hardware 
problem? 


Yes No 


1. Reproduce the operation 

while running Trace event 1. 

2. Turn Trace off with the 
dump option. 

3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 

b. A system level. To do 
this, look at your APAR 
list as described under 
‘Listing the Current 
System Level and 
Currently Installed 
APARs’” in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Follow your local procedures for getting 
the hardware repaired. 


Is the problem with Browse? 


No Yes 
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VO 


Are there any messages that indicate the 
cause of the failure? 


No Yes 
| 
Does the message indicate a 
procedural error? 


No Yes 
| 
Correct the error and 
retry. 


Is the problem resolved? 


No Yes 
| 


Continue with your work. 


Refer to the JBM 3270 Personal 
Computer Guide to Operations and 
run Problem Determination. 


Did the diagnostics find a hardware 
problem? 


Yes e 
1. Reproduce the operation 
while running Trace event 1. 
2. Turn Trace off with the 
dump option. 
3. Follow your local procedures 
and have available: 

a. The sequence of events 
that caused the failure, 
including the keys 
pressed and in what 
order. 
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VON 


b. A system level. To do 
this, look at your APAR 
list as described under 
“Listing the Current 
System Level and 
Currently Installed 
APARs’”’ in Appendix C. 

c. The dump. 

d. Configuration data sets. 


Follow your local procedures for getting 
the hardware repaired? 


You do not appear to have a problem with work 
station control. Continue with your work. 
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Appendix C. Installing and 
Removing Patches 
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Notes: 


Introduction 


This appendix is for anyone who is responsible 
for installing software changes. The Patch Serv- 
ice is a program that runs on DOS. You invoke 
this. program in the personal computer session: 
enter the command INDPATCH and then follow 
the prompts on your screen. When you are in- 
structed to press Enter in the procedures and 
prompts, you can use the New Line key, ¢'_, or 
the Enter key, in the Typewriter Key area. The 
program provides installation or removal of 
permanent changes; called patches or fixes, to 
the code and data. It also provides historical 
tracking and is limited to 100 control program 
patches per release. A problem that the Patch 
Service utility resolves is identified as an Autho- 
rized Problem Analysis Report (APAR). 


This appendix describes how to: 


1. Interpret the information you will put ina 
patch file 


2. Create a patch file 

3. Install a patch 

4. List the current system level 

5. List currently installed APARs 
6. Remove a patch. 


Appendix E contains error messages. 
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Describing the Patch Format 


C-4 


Let’s assume there is a problem within the con- 
trol program. When IBM sends you the patch to 
solve your problem, it will be in a written format 
like this example: 


PRE LEVEL = 2101 

PRE APAR = IRO0001 

ZAP A:\INDCIPL (OFF =01C4, 
VER=10CD21C3, REP = 42424242) 


Following is a description of this example: 
PRE LEVEL = 2101 


@® This is the level the system must be at for 
this patch 


@ It must be the first entry in a patch file 
@ It is always required 
PRE APAR = IR00001 


These are prerequisite APARs you need to 
install first before you install this patch. 
Not all patches have prerequisites. You can 
have between zero and 99 prerequisite 
APARs. 


ZAP 
This line contains the changed data. There 
must be a minimum of one ZAP. 


INDCIPL 
This is the module name where the problem 
resides. 


OFF =01C4 
This is the relative offset value, in hexadeci- 
mal, from the beginning of the module 
named INDCIPL. 


VER = 10CD21C3 
This is the actual data, in hexadecimal, 
beginning at offset value 01C4. 


REP = 42424242 
This is the replacement data, in hexadeci- 
mal, that replaces the verified data begin- 
ning at offset value 01C4. 
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Creating a Patch File 


C-6 


Before you install the patches to your custom- 
ized system diskette, you will need to create a 
patch file for each patch. For a single diskette 
drive, insert your existing system diskette to 

be patched in drive A and create all patch files 
on that diskette. For multidiskette drives, we 
suggest you have your system diskette you are 
patching in drive A and all patch files you create 
on a diskette on drive B or on the fixed disk. For 
a fixed disk, we suggest you create all patch files 
on that fixed disk. Use the EDLIN EDITOR or 
any equivalent editor to create a patch file when 
you are in a personal computer session. To do 
this: 


1. Create a new file, using the APAR number 
for the file name, with the editor that is on 
your system. 


2. Enter the written information you received 
from IBM. If you received the following 
patch, you would use the editor to type the 
three lines exactly as you see them. You can 
press the New Line key, ¢ , or the Enter 
key after each line of information you enter. 


a. Type 
PRE LEVEL = 2101 
and press New Line ¢€ , or Enter. 

b. Type 
PRE APAR = IR00001 
and press New Line ¢€ , or Enter. 

c. Type 

ZAP A: \INDCIPL (OFF =01C4, VER = 10CD21C3, REP = 42424242) 


and press New Line ¢ , or Enter. 


Your file should look like this: 

PRE LEVEL = 2101 

PRE APAR = IROOOO1 

ZAP A: \INDCIPL (OFF =01C4, VER = 10CD21C3, REP = 42424242) 


3. Save your file in accordance with your 
editing procedures. 


So far you have done the following: 

1. Received the patch in written form 

2. Created a file in a personal computer session 
with each APAR number as the file name 
for each patch 


3. Entered the information for each patch into 
each file. 


Remember that a patch file contains one patch. 
If you have three patches to install, you will 
have to create three patch files, each with its 
own unique APAR number for the file name. 


Now you are ready to install a patch. 
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Installing a Patch 
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Note that, if you have a single-diskette drive 
system, the two patch files, INDPATCH.COM 
and INDQPCH.DAT, must both be on the 
customized system diskette. 


If the patch file is on a different diskette or disk, 
place INDPATCH.COM and INDQPCH.DAT on 
that diskette or disk. Make the diskette or disk 
active by typing the drive identifier letter and a 
colon, for example, B:. 


Note: If you do this, make sure the disk drive 
and path information is present for the module 
being changed. 


If the patch file is in a subdirectory, place 
INDPATCH.COM and INDQPCH.DAT in the 
same subdirectory that the APARs are in. Make 
that subdirectory active with the DOS CHDIR 
(Change Directory) command. Refer to the IBM 
Personal Computer Disk Operating System man- 
ual for further information on this command. 


Note: If you do this, make sure the disk drive 
and path information is present for the module 
being changed. 
The following prompts will help you install a 
patch. First, your personal computer session 
must be active. When the DOS prompt appears: 
1. Type 

indpatch 


2. Press New Line ¢ , or Enter. 


3. The following prompt appears: 
<I>nstall, <R>emove, or < L> evel: 
First you are going to install a patch: 
a. Type 
I 
b. Press New Line ¢ , or Enter. 
4, The next prompt appears: 


Type APAR number of patch and press 
Enter or press Enter to Quit 


Type the seven character APAR number 
and press New Line ¢€ , or Enter. This is 
also the file name that contains the patch. 

5. The ZAP data line associated with that 
APAR number appears on your display 
screen: 


ZAP A: \INDCIPL (OFF = 01C4, VER = 10CD21C3, REP = 42424242) Verify is correct 


6. A final prompt indicates that the patch 
has been installed: 


PAT26 Patches Installed 
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Listing the Current System 
Level and Currently Installed 
APARs 


C-10 


You can look at your APAR History List to 
see the current system level and the currently 
installed APARs. To do this: 


1. 


Type 

indpatch 

Press New Line € , or Enter. 

The following prompt appears: 

<I> nstall, <R>emove, or <L>evel: 


a. Type 
L 


b. Press New Line ¢ , or Enter. 


An APAR History List, a listing of 
currently installed APARs on your system, 
appears on your screen. Notice also the 
current system level. Your screen should 
look something like this: 


APAR History 
System Level = 2101 


APAR APAR APAR APAR APAR APAR- APAR 
IR00001 IR00002 [RO0003 IRO0004 ITRO0005 TRO0006 IRO00007 
ITRO0008 IRO0009 [RO00010 TROO011 ITRO0012 IRO0013 IRO00014 


bo 


Removing a Patch 


When you remove a patch, it is removed from 
the IBM 3270 Personal Computer Control Pro- 
gram. The patch file is not deleted. If the patch 
file is on a different diskette or disk, place 
INDPATCH.COM and INDQPCH.DAT on that 
diskette or disk. Make the diskette or disk active 
by typing the drive identifier letter and a colon, 
for example, B:. 


If the patch file is in a subdirectory, place 
INDPATCH.COM and INDQPCH.DAT in the 
same subdirectory that the APARs are in. Make 
that subdirectory active with the DOS CHDIR 
(Change Directory) command. Refer to the IBM 
Personal Computer Disk Operating System man- 
ual for further information on this command. 


If you have to remove more than one patch, we 
suggest you remove your patches in the opposite 
order you installed them. 


Perhaps you need to remove the following two 


APARs: 
@ {R00002 
@® 1R00004 
First remove APAR IRO00004. At the DOS 
prompt: 
1. Type 
indpatch 


2. Press New Line ¢ , or Enter. 
3. The following prompt appears: 


<I>nstall, <R>emove, or < L>evel: 
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4. Type 

R 
5. Press New Line ¢ , or Enter. 
6. The next prompt appears: 


Type APAR number of patch and press 
Enter, or press Enter to Quit 


Type the seven character APAR number 
and press New Line ¢ , or Enter. This is 
also the file name that contains the patch. 


Note: If you do this, make sure the disk 
drive and path information is present for the 
module being changed. 


7. The ZAP data line associated with that 
APAR number appears on your display 
screen: 


ZAP A:\ INDCIPL (OFF =01C4, VER = 10CD21C3, REP = 42424242) Verify is correct 


8. A final prompt indicates that the patch has 
been removed: 


PAT27 Patches removed 


To remove APAR IR00002, follow steps 1 
through 8. 
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Notes: 


Introduction 


Trace is used in gathering data required to 
isolate the causes of software failures in the 
control program and is to be used during 
problem determination. If you encounter prob- 
lems running Trace, refer to Appendix B. 


The Trace Command 


The Trace command runs as a personal computer 
application and is used to turn Trace on and off. 
While running in IBM Personal Computer DOS 
application mode with the personal computer 
window active, the operator issues a Trace On 
command for the trace recordings he wants to 
start or a Trace Off command to stop all trace 
recording. The traces in effect those specified on 
the most recent Trace On command. 


Appendix B identifies which events you must 
turn on to obtain the correct documentation for 
a given problem. 


The syntax of the command is: 


M wn 
ON n 
TRACE M -n 


@ The Trace commands may be typed and 
entered in any combination of uppercase 
and lowercase characters. 
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TRACE OFF /d turns off all trace requests 
and causes the error handler to take a dump. 


One of each of the parameters shown in 
uppercase in a stack must be selected. 


Lowercase parameters are optional. 


M, n, o, and p represent decimal numbers 
corresponding to unique trace identification 
recording requests. 


Single or multiple blanks and/or commas 
delineate individual requests. 


The /d parameter indicates that a dump is 
desired. 


When a dump is requested, your system will 
request you to insert a diskette for the 
dump. This diskette will be formatted; there- 
fore, all existing files on the diskette will be 
erased. After the dump gets control, the 
control program is no longer running. The 


_ only way to restart the system is by turning 


the system off and then on. 
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Notes: 


Introduction 


This appendix is for anyone who needs more 
information about a message that appears on 
the display screen. 


How to Use This Appendix 


The messages in this appendix are grouped by 
type. The groups are in alphabetic order by 
group name. Within each group, the messages 
are in order of their numbers. The message 
number and the message text are in bold type. 
A message explanation and the user response 
follow each message. 


If one of the following types of error codes 
appears on your display screen, refer to 
“Communication Problem Determination”’ in 
Appendix B: 


x S& nnn 
x PROGnnn 
* —\z_nnn 


If your personal computer session is active and 
you receive a message not preceded by one of the 
following message numbers, refer to either the 
IBM Personal Computer Disk Operating System 
manual or to the manual for the application you 
are running. 


CUnnn SYnnn 
PATnn TRnn 
SRnnn TRANSnn 
STnnn WSnnn 
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Customization Messages(C Unnn) 


CU001 Changed item restored to original value 


Explanation: You have made an invalid 
change to a field on a customization panel. 
The incorrect value has been replaced by its 
original value. 


User Response: Correct the value of the 
field or accept the default value. 


CU002 No more space to insert into this field 


Explanation: There is a maximum number 
of characters allowed in this field. You have 
tried to enter more characters than the field 
allows. This message only appears when you 
are in insert mode. 


User Response: Correct the entry and try 
again. 


CU004 That is not a valid place to type 


Explanation: You have tried to type on a 
customization panel in a place where it is 
not valid to do so. Either you have posi- 
tioned the cursor in the wrong place, or this 
option can only be changed by pressing 
PF2. 


User Response: Position the cursor in the 
indicated position, or press PF2 to change 
the option. 


CU005 Only numbers are allowed in this field 


Explanation: You can enter only numbers 
for the value of this field. 


User Response: Replace the value that you 
have typed with a valid number. 


CU006 Name has already been used 


Explanation: Each session must have a 
unique short name. You have already used 
the name you have just typed. 


User Response: Change the name so that it 
is unique. 


CU007 Name does not start with a letter (A-Z) 


Explanation: Names for sessions must start 
with a letter (A-Z). 


User Response: Change the name so that it 
begins with a letter. 


CU008 DOS must be version 2.00 or higher 


Explanation: You are using a version of 
DOS that is too low. The customization 
program requires DOS to be version 2.00 
or higher. 


User Response: Try again with the correct 
version of DOS. 


CU009 Number entered is too large 
Explanation: The number you have typed is 
larger than the maximum value allowed for 


that field. 


User Response: Correct the number and try 
again. 


CU010 Number entered is too small 
Explanation: The number you have typed is 
smaller than the minimum value allowed for 
that field. 

User Response: Correct the number and try 


again. 
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CUO11_ = Failed to write aaaaaaaa.aaa 


Explanation: An error has been detected 
during an attempt to write file 
aaaaaaaa.aaa. Should the error persist, use a 
backup diskette. 


User Response: Refer to ‘‘Customization 
Problem Determination”’ in Appendix B to 
isolate the cause of the failure. 


CU012_ Failed to read aaaaaaaa.aaa 


Explanation: An error has been detected 
during an attempt to open file aaaaaaaa.aaa. 


User Response: Refer to ‘‘Customization 
Problem Determination” in Appendix B to 
isolate the cause of the failure. 


CU013_ Failed to find aaaaaaaa.aaa 


Explanation: File aaaaaaaa.aaa could not be 
found. 


User Response: Refer to ‘‘Customization 
Problem Determination” in Appendix B to 
isolate the cause of the failure. 


CU014 File corrupt aaaaaaaa.aaa 


Explanation: An error has been detected 
during an attempt to open file aaaaaaaa.aaa. 


User Response: Refer to “‘Customization 
Problem Determination” in Appendix B to 
isolate the cause of the failure. 


CU015 Customization incomplete - no system 
configured 


Explanation: You have pressed Esc to quit 
the customization program while it was 
creating a customized system diskette. 


User Response: You cannot use the system 
on that diskette. The customization 
program re-displays the customization 
summary panel with the values that you 
selected for your customized system. To 
create the same customized system on the 
same diskette, press PFS. 


CU016 Not enough storage to run this program 


Explanation: You are trying to run the cus- 
tomization program on a work station with 
insufficient storage. A minimum of 96K 
bytes of storage is required. 


User Response: Refer to ‘Customization 
Problem Determination’’ in Appendix B and 
follow the procedures for message CU016 to 
isolate the cause of the failure. 


CUO017 Insert DOS diskette into drive x 


Explanation: You are trying to create a 
system on a diskette that has not been for- 
matted. This message appears along with 
messages CU031 and CU032 after you have 
pressed PF3 from the customization sum- 
mary panel to create a customized system. 


User Response: Insert the DOS diskette 
into the diskette drive indicated by the mes- 
sage, and close the drive door. The customi- 
zation program formats the system diskette, 
copies the DOS files to it, and then creates 
the customized system. 
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CU018 Insert system diskette into drive x 


Explanation: This is a prompt displayed 
by the customization program while it is 
creating your customized system. 


User Response: Insert the system diskette 
into the diskette drive indicated by the 
message, and close the drive door. 


CU019 Insert Control Program diskette 1 into 
drive x 


Explanation: This is a prompt displayed 
by the customization program while it is 
creating your customized system. 


User Response: Insert Control Program 
diskette 1 into the diskette drive indicated 
by the message, and close the drive door. 


CU020 Insert Control Program diskette 2 into 
drive x 


Explanation: This is a prompt displayed 
by the customization program while it is 
creating your customized system. 


User Response: Insert Control Program 
diskette 2 into the diskette drive indicated 
by the message, and close the drive door. 


CU021 Strike any key when ready... 


Explanation: This is a prompt displayed by 
the program. 


User Response: When you are ready to 
proceed, strike any key. 


CU023 Embedded blanks are not allowed 


Explanation: You are not allowed to use 
blank characters in names. Only letters 
(A-Z) and numbers (0-9) can be used. 


User Response: Correct the name. 


CU024 Only letters (A-Z) and numbers (0-9) are 
allowed 


Explanation: You can enter only letters 
(A-Z) and numbers (0-9) in the value for this 
field. 


User Response: Correct the entry. 


CU025 Cannot customize system with incorrect 
values 


Explanation: You have pressed PF8, to 
create your system diskette, while you have 
an invalid value on the summary panel. 


User Response: Correct the value, and try 
again. 


CU031 System diskette requires formatting 


Explanation: You are trying to create a 
system on a diskette that has not been for- 
matted. This message appears along with 
message CU032 after you have pressed PF3 
from the customization summary panel to 
create a customized system. 


User Response: See the user response for 
message CU032. 
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CU032 Type drive letter for DOS diskette and 


press PF3 


Explanation: You are trying to create a 
system on a diskette that has not been for- 
matted. This message appears along with 
message CU031 after you have pressed PF3 
from the customization summary panel to 
create a customized svstem. 


User Response: Type the letter of the drive 
for the DOS diskette, then press PF3. The 
customization program formats the system 
diskette, copies the DOS files to it, and then 
creates the customized system. 


CU033 System files already exist on target 


disk 


Explanation: You are recustomizing a sys- 
tem on a diskette or fixed disk that already 
contains the files that are needed for a cus- 
tomized system. This message appears 
along with message CU034 after you have 
pressed PF3 from the customization sum- 
mary panel to create a customized system. 


User Response: See the user response for 
message CU034. 


CU034 Do you want them replaced? (Y/N) 


Explanation: You are recustomizing a sys- 
tem on a diskette or fixed disk that already 
contains the files that are needed for a cus- 
tomized system. This message appears 
along with message CU033 after you have 
pressed PF3 from the customization sum- 
mary panel to create a customized system. 


User Response: If you only need to replace 
the configuration table INCDFIG.FIL, type 
‘“‘N’’. If you have patched any files on your 
system diskette, or received a refresh of the 
code, you will need to replace all of the sys- 
tem files that are on your target diskette. 
Type ‘‘Y’’ to replace all of the system files. 


CU035 Customization complete 


Explanation: The customization program 
has transferred all of the files needed for 
your customized system onto the target 
diskette. The customization summary panel 
is now re-displayed with the values you se- 
lected for your customized system. 


User Response: You can create another 
copy of this same system with the same val- 
ues by pressing PF3. You can create a dif- 
ferent customized system by changing any 
of the values on the customization summary 
panel and then pressing PF3. You can end 
the customization program by pressing Esc. 
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CU036 Incorrect diskette 


Explanation: You have inserted an incorrect 
diskette in response to one of the customiza- 
tion prompts. 


User Response: Remove the incorrect disk- 
ette from the drive indicated by the prompt- 
ing message, insert the correct diskette into 
the drive indicated by the prompting mes- 
sage, and strike any key to continue. 


CU999_ Internal error - please report. 


Code = nn 


Explanation: The customization program 
has detected an internal error. 


User Response: Write down the code 
number that appears in the message. You 
will need this number to report this prob- 
lem. Follow your local procedures and have 
available: 


1. The code number from message CU999 


2. The sequence of events that led up to 
the failure. 


Patch Installation Messages 
(PATnn) 


There may be times when DOS messages appear, 
in addition to Patch messages, while you are 
using the Patch facility. If this happens, refer to 
your IBM Personal Computer Disk Operating 
System manual for explanations. 


PAT0O1 Empty patch file 


Explanation: Data was not found in the 
patch file specified. 


User Response: Add the Patch information 
to the failing patch file. 


PAT02 Zap data not specified 


Explanation: Zap data was not found in the 
patch file specified. 


User Response: Add the zap information to 
the failing patch file. Make sure you press 
the New Line key € after every entry in 
the patch file. See “Creating a Patch File’”’ 
in Appendix C for further information. 


PAT0O3 Prerequisite system level not specified 
Explanation: The first entry in the patch 
file is a required system level, and none was 


found. 


User Response: Add the system level as the 
first entry in the failing patch file. 
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PAT04 Current - system level = (2101) 
But patch prerequisite is - system 
level = (2102) 


Explanation: The first entry in the patch 
file specified a prerequisite APAR level of 
(2102), but the system is currently at a 
system level of (2101). 


User Response: Either upgrade the system 
level to (2102) or correct the patch file, 
whichever caused the failure. 


PAT0O5 Requested APAR (aannnnn) already 
installed 


Explanation: The APAR number specified 
is already installed on the system. 


User Response: Verify that you typed in 
the correct APAR number. If you did, refer 
to ‘‘Patch Problem Determination”’ in 
Appendix B. If you typed an incorrect 
APAR number, correct and retry. 


PAT06 Requested APAR (aannnnn) not 
installed 


Explanation: The APAR number specified 
is not currently installed on the system 


when the user is attempting to remove an 
APAR. | 


User Response: Determine whether: 
@ The APAR was removed previously or 


@ An incorrect APAR number was 
specified. . 


PATO7 Prerequisite APAR (aannnnn) not 
installed 


Explanation: The APAR number specified a 
prerequisite APAR of aannnnn, but that 
APAR is not currently installed on the 
system. 


User Response: Verify that the prerequisite 
APAR entry in the patch file is correct. 
Then install the required prerequisite APAR 
and retry the operation. 


PAT08 INDQPCH.DAT history file not found 
on this diskette 


Explanation: Either: 


@ The diskette you are attempting to 
patch is not a customized control 
program diskette or 

@® The INDQPCH.DAT history file has 
been deleted or is not on the diskette, 
the disk, or the subdirectory the patch 
is in. 


User Response: 


@ Place the control program diskette in 
the default drive or 

@ If the history file INDQPCH has been 
deleted from the diskette, use the most 
current backup of your system diskette 
and install any fixes required to bring 
the system up to the current level. 


PAT09 Maximum APARs installed 
Explanation: The system allows a maxi- 
mum of 100 APARs to be installed for a 
given refresh level. 

User Response: Upgrade your system to the 


most current refresh level. 
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PAT10 Patch file for APAR (aannnnn) not 


found 


Explanation: The APAR number was not 
found. 


User Response: This error can be caused by 
either: 


@® Entering an incorrect APAR number or 

@® Failing to specify the diskette drive 
identifier if the APAR file is on a disk- 
ette drive other than the current default 
drive or 

@® The patch file is not on the diskette. 


PAT11 OFFset invalid or missing 


Explanation: The OFF = keyword in the 
zap data of the patch file was either missing 
or misspelled. 


User Response: Correct the zap data and 
retry the operation. 


PAT12 VERify invalid or missing 


Explanation: The VER = keyword in the 
zap data of the patch file was either missing 
or misspelled. 


User Response: Correct the zap data and 
retry the operation. 


PAT13 REPlace invalid or missing 


Explanation: The RE P= keyword in the 
zap data of the patch file was either missing 
or misspelled. 


User Response: Correct the zap data and 
retry the operation. 


PAT14 Invalid hex offset data 


Explanation: The offset data in the zap line 
either contained nonhexadecimal data or 
was missing. 


User Response: Correct the zap data and 
retry the operation. 


PAT15 Invalid hex verify data 


Explanation: The verify data in the zap line 
either contained nonhexadecimal data or 
was missing. 


User Response: Correct the zap data and 
retry the operation. 


PATI16_ Invalid hex replace data 


Explanation: The replace data in the zap 
line either contained nonhexadecimal data or 
was missing. You may see “Verify is cor- 
rect’’ before getting this message. This indi- 
cates that only the replace data is incorrect. 


User Response: Correct the zap data and 
retry the operation. 


PAT17 Comma or parenthesis missing 
Explanation: A required delimiter is miss- 
ing from the displayed zap line. You must 
have left and right parentheses and two 


commas in the zap line. 


User Response: Correct the zap data and 
retry. 
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PAT20 PATCH =ZAP Imod 
(OFF = hhbh, VER = hhbhh,REP = hhhh) 
module not found 


Explanation: The module specified in the 
zap data was not found during patch data 
verification. 


User Response: 


@ Ifthe zap data is incorrect, correct the 
data and retry the operation. 

@ If the data is correct, determine why 
the module was not found. There may 
be: 

— An incorrect diskette drive speci- 
fier or 

— A deleted module. If a module has 
been deleted, use a backup copy 
and retry the operation. 


PAT21 PATCH =ZAP Imod 
(OFF = hhhbh, VER = hhhh,REP = hhbh) 
mismatch 
MODULE = MOD = hh 


Explanation: The verify data specified in 
the zap data line does not match the verify 
data in the module when you are installing 
patches. 


User Response: 


@ Ifthe zap data is incorrect, correct the 
data and retry the operation. 
@ If the data is correct, record all data 
related to the problem. Include both: 
— A screen print 
— Acopy of the diskette and follow 
local procedures. 


PAT22 PATCH =ZAP lmod 
(OFF = hhbh, VER = hhbh,REP = hhhh) 
mismatch 


MODULE = MOD = hh 


Explanation: The verify data specified in 
the zap data line does not match the verify 
data in the module when you are removing 
patches. 


User Response: The zap data file for this 
patch has been changed since the APAR 
was installed. Correct the data file and retry 
the operation. 


PAT23 Prerequisite APAR invalid or not 
specified 


Explanation: Either the keyword PRE or 
APAR is misspelled or missing on one of the 
APAR prerequisite entries. 


User Response: Correct the keyword data 
and retry the operation. 


PAT24 Error in zap data - patches not installed 


Explanation: An error in the zap data was 
encountered. Preceding error messages iden- 
tified the type of error. This message always 
appears with another message. 


User Response: Correct the problem identi- 
fied by all preceding messages and retry. 


PAT25_ Error in zap data - patches not removed 
Explanation: An error in the zap data was 
encountered. A preceding error message 
identified the type of error. This message 


always appears with another message. 


User Response: Correct the problem identi- 
fied by all preceding messages and retry. 
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PAT26_ Patches installed 
Explanation: The patch was installed, 
and the history file INDQPCH.DAT was 
updated. 
User Response: None. 

PAT27 Patches removed 
Explanation: The patch was removed, 
and the history file INDQPCH.DAT was 
updated. 


User Response: None. 


Save and Restore Messages 


(SRnnn) 


SR001 Save command being processed 
Explanation: Information message. 
User Response: None. 

SR002 Restore command being processed 
Explanation: Information message. 
User Response: None. 


SR003 Autokey information saved 
successfully 


Explanation: Information message. 
User Response: None. 


SR004 = %%%%%%%% information restored 
from %7%!7% %!l%V% at %o%:%o % 


Explanation: Information message. The 
information for the first variable is one of 
the following: 


@® Autokey 
@ Screen 
@ Notepad 


The second variable contains the date when 
the information was saved. 


The third variable contains the time the 
information was saved. 


It is suggested you always set the time and 
date before doing a save, or the default date 
and time will be used. 
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SR005 Notepad information saved successfully 
Explanation: Information message. 
User Response: None. 

SR006 Screen profiles saved successfully 
Explanation: Information message. 
User Response: None. 

SR007 Save processing complete 
Explanation: Information message. 
User Response: None. 

SR008 Restore processing complete 
Explanation: Information message. 
User Response: None. 


SRO11 = Error opening % % % %%%%% personal 
computer file 


Explanation: The file specified (or the 
default file) could not be opened. 

% To To Yo To Yo Yo Yo refers to the specific type of 
personal computer file. There are 3 types: 


@ Autokey 
@ Notepad 
@® Screen 


User Response: If you specified a filespec 
on the command, check to be sure that it 
was specified correctly. Make sure the drive 
door is closed. Enter the DOS directory 
command, Dir, to check the personal 
computer filename and extension. 


Note: The Save and Restore commands 
accept four keywords: 


® Autokey 
@® Notepad 
@® Screen 

@ Notepadn 


If the command is not followed by one of 
the above keywords, filespec is the assumed 
parameter. Make sure you typed these key- 
words correctly. Make sure the directory or 
sub-directory you are attempting to restore 
from has the file residing there. If you find 
no error in your procedures, follow local pro- 
cedures and have available: 


1. The message number. 


2. The sequence of events that caused the 
failure, including the keys pressed and 
in what order. 


3. A system level. To do this, look at your 
APAR list as described under ‘‘Listing 
the Current System Level and Currently 
Installed APARs”’ in Appendix C. 


SR012_ ‘Error creating personal computer file 


Explanation: The personal computer file 
could not be created. 


User Response: Check the filespec specified. 
If you named a path, make sure the path ex- 
ists. Be sure that the diskette drive door is 
closed. If the failure persists, refer to “‘Save 
and Restore Problem Determination” in Ap- 
pendix B to isolate the cause of the failure. 
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SR013 Error reading from personal computer 


file 


Explanation: A read request failed to com- 
plete processing successfully. This message 
may indicate a program error. 


User Response: Be sure the drive door is 
closed. If the drive door is closed, and the 
failure persists, refer to ‘“Save and Restore 
Problem Determination” in Appendix B to 
isolate the cause of the failure. 


SR014_ Error writing to personal computer file 


Explanation: A write request failed to 
complete processing successfully. 


User Response: The most probable cause 
for this message is that the disk is full. 
Check the number of bytes available on the 
current disk. Retry the operation when you 
have made more space available. 


SRO015 Personal computer filespec incorrect 


Explanation: The drive specified in the 
filespec does not exist on the current 
configuration. 


User Response: Retry the operation, speci- 
fying a valid drive in the filespec. 


SR016 Personal computer storage insufficient 


for processing 


Explanation: No enough system storage 
is currently available for Save/Restore to 
process any requests. 


User Response: You need to have more 
space available for Save/Restore to process 
any requests. 


SRO017_ ~=—‘Invalid file specified for Restore 


Explanation: Either the file specified on the 
Restore command is not a previously saved 
save file for the request type specified or 
system storage has been overlaid. 


User Response: Check to be sure that the 
file being used on the Restore command is a 
previously saved save file for the request 
type that is being stored. If no error can be 
found in your procedures, follow local proce- 
dures and have available: 


1. The message number. 


2. The sequence of events that caused the 
failure, including the keys pressed and 
in what order. 


3. A system level. To do this, look at your 
APAR list as described under ‘‘Listing 
the Current System Level and Currently 
Installed APARs’”’ in Appendix C. 


SRO018 Not all notepads that were saved could 
be restored 


Explanation: This is an informational 
message only, which indicates that there 
are fewer notepads defined on the current 
system than there were on the saved 
system. 


User Response: None. The restore will 
complete processing successfully with as 
many notepads as are defined on the current 
system being restored and the remaining 
will be disregarded. 


SR019 Save or Restore failed with error code 
xX 


Explanation: This message indicates a 
program error. 
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User Response: Follow your local proce- 
dures and have available: 


1. The message number. 


2. The sequence of events that caused the 
failure, including the keys pressed and 
in what order. 


3. A system level. To do this, look at your 
APAR list as described under “‘Listing 
the Current System Level and Currently 
Installed APARs”’ in Appendix C. 


SR020 Window configuration error 


Explanation: During a restore request for 
the screen profile, a configuration error was 
detected. Either a window that was not con- 
figured on Screen Profile 0 of the current 
system is trying to be restored, or the 
maximum number of window definitions (40) 
already exists. 


User Response: Screen profiles can be re- 
stored only on systems configured with the 
same windows defined on Screen Profile 0. If 
this is not the case, then the maximum num- 
ber of windows has been defined and some 
must be deleted before new ones can be 
defined. 


SR021 Keyboard locked 


Explanation: The Save or Restore request 
failed because another operation locked the 
keyboard. 


User Response: Wait for the other operation 
to complete processing and retry. If the 
other operation does not complete, refer to 
““Save and Restore Problem Determination”’ 
in Appendix B to isolate the problem. 


SRO022 Autokey record operation in progress 


Explanation: The Save or Restore request 
failed because an autokey record operation 
was in progress. 


User Response: Wait for the autokey record 
operation to complete processing and retry. 
If the other operation does not complete, 
refer to ‘‘Save and Restore Problem Deter- 
mination” in Appendix B to isolate the 
problem. 


SR023 Autokey playback operation in progress 


Explanation: The Save or Restore request 
failed because an autokey playback opera- 
tion was in progress. 


User Response: Wait for the autokey play 
operation to complete processing and retry. 
If the other operation does not complete, 
refer to ‘“Save and Restore Problem Deter- 
mination”’ in Appendix B to isolate the 
problem. 


SR024_ Incorrect window name for single note- 
pad requests 


Explanation: The window name specified on 
a single notepad request or Restore must be 
a notepad window. 


User Response: Reissue the command, spec- 
ifying a valid notepad window name for the 
current system configuration. 


SR025 _ Filespec must be specified on single 
notepad requests 


Explanation: When a single notepad Save 
or Restore was requested, the filespec was 
omitted. 


User Response: Reissue the command, spec- 
ifying the filespec as the second parameter. 
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SR026 + Filenames specified in the file record 
are invalid 


Explanation: The Save or Restore request 
failed because you specified a filename con- 
taining invalid filespec information. 


User Response: Specify a filename contain- 


ing valid filespec information and retry the 
operation. 
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SR029_ Restoring file which were saved on an 


IBM 3270 Personal Computer %% 7% % 
display 


Explanation: Information message. %%%% 
refers to one of the following: 


@ 5251 
@ 5272 


User Response: None. 
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ST001 Incorrectly customized diskette. 


Memory allocation error 


Explanation: There is an error in the 
apparent size of one of the Control Program 
files and it cannot be loaded into the correct 
position in memory. The system diskette 
contains logical errors, or there was a pro- 
gram error during customization. 


User Response: Replace the system diskette 
with a backup system diskette or repeat the 
customization. If the error persists, refer to 
“System Startup Problem Determination’’ 
in Appendix B. 


ST002 Incorrectly customized diskette. Cannot 


find % % % % % % % % % . % %o % 


Explanation: The file named is not on the 
system diskette. The system diskette con- 
tains logical errors, or there was a program 
error during customization. 


User Response: Replace the system diskette 
with a backup system diskette or repeat the 
customization. If the error persists, refer to 
“System Startup Problem Determination”’ 
in Appendix B. 


ST003 ‘I/O error reading file 


J % % % % % % % To Jo % from drive Zo 


Explanation: The system diskette contains 
1/O errors. 


User Response: Replace the system diskette 
with a backup system diskette or repeat the 
customization. If the error persists, refer to 
“System Startup Problem Determination”’ 
in Appendix B. 


ST004 Insufficient memory to load control 
program 


Explanation: The available memory is too 
small to load the version of the control pro- 
gram on your customized system diskette. 


User Response: Remove any resident appli- 
cations or customize for a system with fewer 
functions, for example, with fewer host ses- 
sions or notepads. If the error persists, refer 
to “System Startup Problem Determination’ 
in Appendix B. 


, 


ST005 = Incorrect format for file 
% 70 To %o 70 Vo To Yo. 70 Vo To 


Explanation: The file named is not accept- 
able to the IBM 3270 Personal Computer. 
The system diskette contains logical errors, 
or there was a program error during 
customization. 


User Response: Replace the system diskette 
with a backup system diskette or repeat the 
customization. If the error persists, refer to 
“System Startup Problem Determination’”’ 
in Appendix B. 


ST006 = Incorrectly customized diskette. Illegal 
filespec 


Explanation: One of the files on the system 
diskette has a filespec that is not valid on 
the IBM 3270 Personal Computer. The 
system diskette contains logical errors, or 
there was a program error during the 
customization. 


User Response: Replace the system diskette 
with a backup diskette or repeat the cus- 
tomization. If the error persists, refer to 
“System Startup Problem Determination”’ 
in Appendix B. 
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ST007 Cannot find message file 


Jo To To To To To To Vo . To To Vo 


Explanation: The named message file 
cannot be found while loading the control 
program (during IPL) or when a Personal 
Computer program such as Send/Receive 
or Patch is started. The message file is 
assumed to be available on the default disk 
drive. 


User Response: Make sure the named mes- 
sage file is available on the default disk 
drive and retry the operation. If the error 
persists, refer to “System Startup Problem 
Determination” in Appendix B. 


System Error Messages 


SY001 System fatal error - %7%%% % % % % 


Explanation: The IBM 3270 Personal Com- 
puter Control Program has encountered an 
error that it cannot recover from. The varia- 
ble data 7%%%% % %% is used in the 
problem determination process. This mes- 
sage is always followed by message SY006. 


User Response: Record the variable data in 
the message and refer to ‘“System Error 
Problem Determination” in Appendix B. 


SY002 Component fatal error - 
% % Yo % Yo Yo Yo Yo 


Explanation: One of the components in the 
IBM 3270 Personal Computer Control Pro- 
gram has had an unrecoverable error. The 
variable data %%%%% % % % is used in 
the problem determination process. 


User Response: Record the variable data in 
the message and refer to ‘‘System Error 
Problem Determination” in Appendix B. 


SY003 Component error - %7%%%%%%% 


Explanation: One of the components has 
encountered a recoverable error. 


User Response: If the error persists, record 
the variable data 7™%%%%%%% in the 
message and refer to ‘“‘“System Error Prob- 
lem Determination” in Appendix B. 


SY004 System error -%7%%%%% % % 
Explanation: The IBM 3270 Personal 


Computer Control Program has encountered 
an unexpected error condition. 
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User Response: Record the variable data 
% % %o % % Yo % in the message and the 
events leading up to the failure. Refer to 
“System Error Problem Determination”’ in 
Appendix B. 


SY005 Component informational - 
% % Yo Yo Yo Yo Yo Yo 


Explanation: The IBM 3270 Personal Com- 
puter Control Program is reporting statisti- 
cal information, not error information. 


User Response: None. 


SY006 Do you want a dump? Data will be 
destroyed (Y/N) 


Explanation: This message is issued if the 
IBM 3270 Personal Computer Control 
Program has encountered an unrecoverable 
system failure and has issued message 
SY001, or the user has turned Trace off with 
the /d option. 


User Response: Reply “‘Y’’ to take a dump, 
or “‘N”’ to reload the control program. If the 
keyboard does not respond and if you have 
an NMI button, press the red NMI button 
at the back of the system unit again to start 
the process. See ‘“‘System Error Problems 
Determination’’ in Appendix B. 


SY007 Insert a blank diskette. Press D when 
ready 


Explanation: The user has replied “Y”’ to 
message SY006. 


User Response: Insert a blank diskette in 
drive A and either press D or, if you have a 
red NMI button at the back of the system 
unit, press this button to take a dump. See 
‘System Error Problems Determination” in 
Appendix B. 
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SY008 Insert another blank diskette. Press D 
when ready 


Explanation: A dump is in progress and 
another diskette is required. 


User Response: Insert another blank disk- 
ette in drive A and press D or the red NMI 
button to take a dump if you have an NMI 
button at the back of the system unit. See 
‘“System Error Problems Determination”’ in 
Appendix B. 


SY009_ Parity check 1 in Segment xxxx: log off 
and run diagnostics 


Explanation: There has been a parity check 
on the main system board. Segment xxxx is 
the starting segment address of the 16K 
block of memory containing the parity 
check. If xxxx equals FFFF, the memory 
location where the parity check occurred 
could not be found. 


User Response: Try to log off the host 
computer sessions. Then run the diagnostic 
programs to isolate the problem. 


SY010 Parity check 2 in Segment xxxx: log off 
and run diagnostics 


Explanation: There has been a parity check 
on an expansion board. Segment xxxx is the 
starting segment address of the 16K block 
of memory containing the parity check. If 
xxxx equals FFFF, the memory location 
could not be found. 


User Response: Try to log off the host 


computer sessions. Then run the diagnostic 
programs to isolate the problem. 
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SY011 Dumping.... 


Explanation: The IBM 3270 Personal 


-Computer Control Program is writing the 


contents of memory onto the diskette. 


User Response: None. 


SY012 Dump completed. Insert system disk- 


ette and press any key to re-IPL 


Explanation: The dump process is done. 
The system is in a Halt state. 


User Response: Insert your customized 
system diskette and press any key to reload 
your control program. 


SY013 Dump failed. Try again? (Y/N) 


Explanation: An error has been encountered 
during the dump process. 


User Response: Reply “Y”’ if you want the 
dump. Reply ‘‘N”’ if you do not want the 
dump. In either case, power-off the machine 
to recover. If the retry operation is not 
successful, refer to “System Error Problem 
Determination”’ in Appendix B. 


SY014 Warning: The needed graphics adapter 


is not attached 


Explanation: You do not have a graphics 
adapter attached and you tried to use a 
personal computer graphics application. 


User Response: If this message appears and 
you do not have a graphics adapter, 


1. Remove the message by pressing the 
WS Ctrl key twice. 


2. Reload IBM Personal Computer DOS 
by pressing Alt + Ctrl + Del. 


If this message appears and you do have a 
graphics adapter, refer to the IBM 8270 Per- 
sonal Computer Guide to Operations and 
perform the checkout procedure for the 
adapter. If you find no hardware problem, 
refer to your local procedures and have 
available: 


1. The sequence of events that caused the 
failure, including the keys pressed and 
in what order. 


2. A system level. To do this, look at your 
APAR list as described under “Listing 
the Current System Level and Currently 
Installed APARs”’ in Appendix C. 


3. 38270 Personal Computer Hardware 
configuration including model numbers, 
installed cards, and memory size. 


SY015  Formatting.... 


Explanation: The IBM 3270 Personal 
Computer Control Program is formatting 
the diskette you are using for the dump. 


User Response: None. 


SY016 Format failed. Insert another diskette, 
press D when ready 


Explanation: There is an error encountered 
during the formatting of the diskette. The 
dump diskette you just inserted in drive A 
is probably write-protected, or there are 
some damaged sectors on it. 


User Response: Insert another blank disk- 
ette in drive A and press D or press the red 
NMI button, if you have one, at the back of 
the system unit. If the retry operation fails, 
refer to ‘‘System Error Problem Determina- 
tion’’ in Appendix B. 
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Trace Messages (TRnnn) 
TRO1 Invalid command format or missing 
parameter 
Explanation: The Trace command contains 
invalid information or a required parameter 
is missing. 


User Response: Correct the command and 
retry the operation. 


TRO2 Invalid trace id or range specified 


Explanation: One of the ids or ranges 
specified is incorrect. 


User Response: Correct the command and 
retry the operation. 


TRO3 Invalid parameter 


Explanation: The Trace command was 
specified with an invalid parameter. 


User Response: Correct the command and 
retry the operation. 


TRO4  Background/foreground interface error 


Explanation: The Trace encountered an 
internal error. 


User Response: Follow your local proce- 
dures and have available: 


1. The sequence of events that caused the 


failure, including the keys pressed and 
in what order. 
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2. A system level. To do this, look at your 
APAR list as described under ‘‘Listing 
the Current System Level and Currently 
Installed APARs” in Appendix C. 

TRO6 Requested traces have been enabled 


Explanation: Trace has been turned on in 
response to a Trace On command. 


User Response: None. 
TRO7 ~~ All traces have been disabled 


Explanation: All traces have been turned 
off in response to a Trace Off command. 


User Response: None. 
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File Transfer Messages 
(TRANSnn) 
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TRANSO1 File transfer command being 


processed 


Explanation: This message will appear 
when the file transfer command is entered 
and processing by the system has begun. 


User Response: None. Wait for message 
TRANSO2 to appear. 


TRANSO2 Number of bytes of file transferred 


so far: = => XXXX 


Explanation: This is a progress message 
that tells you how many bytes of the per- 
sonal computer file have been transferred to 
or from the host. The number is updated as 
the file is transferred. After the entire file 
has been transferred, TRANSO3 File trans- 
fer complete will appear. If the transfer does 
not complete successfully, a file transfer 
error message will appear. 


User Response: Wait for file transfer to 
complete. 


TRANSO3 File transfer complete 


Explanation: The file transfer operation has 
been completed successfully. There is now a 
file either at the host or at the personal com- 
puter whose name and characteristics are 
those you specified in the Send or Receive 
command. 


User Response: None. 


TRANSO4 File transfer complete with records 
segmented 


Explanation: The file transfer operation has 
been completed. Any record greater than the 
set logical record length (LRECL) of the file 

being appended will divide and become mul- 

tiple records. 


User Response: None. 


TRANSO5 Personal computer filespec incor- 
rect: file transfer canceled 


Explanation: The user has made an error 
in the personal computer DOS filespec, for 
example, diskette drive, path, filename, or 
extension. 


User Response: Compare the personal 
computer DOS filespec in the file transfer 
command, which will still be visible in the 
personal computer session, with the user 
manual to make sure it conforms to the 
personal computer DOS requirements for a 
filespec. If the filespec is correct, it is possi- 
ble that the specified personal computer file 
does not exist on the personal computer 
disk. You should use the DOS directory 
command, Dir, to check the personal com- 
puter filename and extension. 


TRANSO6 Command incomplete: file transfer 
canceled 


Explanation: The user did not enter any 
parameters after Send or Receive. 


User Response: Read the user manual on 


requirements for the Send and Receive 
commands and retry. 
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TRANSO7 Cannot link to host: file transfer 


canceled 


Explanation: This message indicates some 
kind of host connection problem. 


User Response: If you see this message, file 
transfer may not be working properly. Ver- 
ify that the host is operating. If it is, refer 
to ‘‘File Transfer Problem Determination”’ 
in Appendix B to isolate the cause of the 
failure. 


TRANSO8 Command transmit error: file 


transfer canceled 


Explanation: This message will occur if 
there is a program error or if a key was 
pressed that produced an invalid code, for 
example, one that cannot be transmitted to 
the host. 


User Response: Retry file transfer after 
carefully reading the instructions in Chapter 
13. Check the status of the host; there may 
be some information on the host session 
indicating the problem. If the host is 
operating, refer to ‘‘File Transfer Problem 
Determination’’ in Appendix B to isolate the 
cause of the failure. 


TRANSO9 Error reading file from damaged 


personal computer disk: file transfer 
canceled 


Explanation: This message indicates that 
the personal computer disk or diskette is 
probably damaged. 


User Response: Retry the operation with a 
backup copy of the file being transferred. If 
the failure still occurs, refer to the IBM 8270 
Personal Computer Guide to Operations and 
run a system checkout for either the disk- 
ette drive or fixed disk. 


TRANS10 Host has not responded within 
timeout period: refer to user’s guide 
for more information 


Explanation: The host has not responded to 
the file transfer within several seconds. 


User Response: If the host session screen 
shows HOLDING, you can switch to the 
host session and press Clear (in VM/CMS) or 
PA2 (in TSO). This should start file transfer. 
If *& SYSTEM or % °¢ appears in the host 
session screen operator information area, 
wait for it to clear. These indicate the sys- 
tem is working slowly. If you want to halt 
file transfer after several time-out messages 
appear, switch to the host session, press Re- 
set to clear the operator information area, 
and press PF2 to halt the file transfer, or 
Clear to continue. This problem can be 
caused by line problems. 


TRANSI1 Lost contact with host: file transfer 
canceled 


Explanation: The host is inactive. 


User Response: Refer to ‘‘File Transfer 
Problem Determination” in Appendix B. 


TRANS12_ Error writing to damaged or full per- 
sonal computer disk: file transfer 
canceled 


Explanation: This message indicates that 
the personal computer disk or diskette has 
become full during a Receive operation, or 
that the disk or diskette may be damaged. 


User Response: Retry the operation with a 
backup copy of the file being transferred. If 
the failure still occurs, refer to the IBM 8270 
Personal Computer Guide to Operations and 
run a system checkout for either the disk- 
ette drive or fixed disk. 
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TRANS13 Error writing file to host: file 
transfer canceled 


Explanation: The host program has detected 
an error in the file data being sent to it by 
the Send program. 


User Response: Retry file transfer. If the 
message occurs again, refer to ‘“‘File Trans- 
fer Problem Determination” in Appendix B 
to isolate the cause of the failure. 


TRANSI4 Error reading file from host: file 


transfer canceled 


Explanation: The host program has detected 
an error in the file data during a Receive 
operation. 


User Response: Retry file transfer. If the 
message occurs again, refer to ‘‘File Trans- 
fer Problem Determination”’ in Appendix B 
to isolate the cause of the failure. 


TRANS15 Required host storage unavailable: 
file transfer canceled 


Explanation: You need 30K of main storage 
for file transfer, in addition to that required 
by your host. This should not be confused 
with disk space. 


User Response: Contact your local host 
system support representative. 


TRANSI6 Incorrect request code: file transfer 
canceled 


Explanation: An invalid parameter has been 
sent by the Send or Receive application. 
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User Response: Verify that current versions 
of Send, Receive, and IND$FILE MODULE 
are correctly installed. If they are, follow 
local procedures and have available: 


1. The sequence of events, including keys 
pressed and in what order 


2. A-system level. 


TRANSI17 (TSO version) Missing or incorrect 
TSO data set name: file transfer 
canceled 


Explanation: TSO data set name is missing 
or not a sequential or partitioned data set. 


User Response: Correct the TSO data set 
name in the command and retry. 


TRANS17 (CMS version) Missing or incorrect 
CMS file name; file transfer 
canceled 


Explanation: CMS file name is missing or 
incorrectly specified. 


User Response: Correct the CMS file name 
in the command and retry. 


TRANSI18 Incorrect option specified: file 
transfer canceled 


Explanation: User specified an option that 
is not acceptable. 


User Response: Correct the command to 
specify an acceptable option and retry. 


TRANSI9 Error while reading or writing to 
host disk: file transfer canceled 


Explanation: There is not enough space 
available for data on the host. 
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User Response: Look at the host session 
message for indications and correct the 
problem. 


TRANS22 Host session identifier incorrect: file 


transfer canceled 


Explanation: The host session specified by 
the id parameter in the file transfer com- 
mand does not exist. 


User Response: Determine which identifier 
you should be using by checking the host 
session identification using List (PF1). 


TRANS23 Activity specified not a host session: 


file transfer canceled 


Explanation: The identifier (id) specified in 
the file transfer command is not for a host 
session. 


User Response: Press List (PF 1) to identify 
the host windows. Reissue the file transfer 
command. 


TRANS24 Autokey operation in progress: file 


transfer canceled: 
Explanation: Autokey is active. 


User Response: Wait until the autokey 
operation is complete and retry. 


TRANS25 Keyboard inhibited: file transfer 


canceled 


Explanation: The host session is not able to 
accept file transfer because the keyboard is 
locked. 


User Response: Wait until the keyboard is 
free to receive and retry. If the keyboard is 
not freed, refer to ‘‘File Transfer Problem 
Determination ” in Appendix B to isolate 
the cause of the problem. 


TRANS26 Unrecoverable system error: file 
transfer canceled 


Explanation: This message indicates a 
program error. 


User Response: Follow local procedures 
and have available: 


1. Sequence of events, including keys 
pressed and in what order 


2. The message number 
3. System level 


TRANS27 Communication sequence with host 
disrupted: file transfer canceled 


Explanation: This indicates a program error 
or the Ctrl + Break has been pressed. 


User Response: Follow local procedures 
and have available: 


1. Sequence of events, including keys 
pressed and in what order 


2. The message number 
3. System level 


TRANS28 Invalid option XXXXXXXX: file 
transfer canceled 


Explanation: XXX XXX XX is replaced with 
the invalid option. The option is either not 
recognized, is specified as a positional 
keyword, or has an associated value that is 
incorrect. 


User Response: Correct the option in the 
command and retry. 
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TRANS29 Invalid option XXXXXXXX with 


RECEIVE: file transfer canceled 


Explanation: XXX XXX XX is replaced with 
the invalid option. The option is not valid 
with RECEIVE, but can be used with 
SEND. 


User Response: Remove the option from the 
command and retry. 


TRANS30 Invalid option XXXXXXXX with 


APPEND: file transfer canceled 


Explanation: XXXXXXXX is replaced with 
the invalid option. The option is not valid 
with APPEND, but otherwise can be used. 


User Response: Remove the option from the 
command and retry. 


TRANS31 Invalid option XXXXXXXX with- 


out SPACE: file transfer canceled 


Explanation: XXXXXXXX is replaced with 
the invalid option. The option can only be 
used if SPACE is also specified. 


User Response: Remove the option from the 
command and retry. 


TRANS32_ Invalid option XXXXXXXX with 


PDS: file transfer canceled 


Explanation: XXXXXXXX is replaced with 
the invalid option. The option is invalid with 
a host partitioned data set. 


User Response: Remove the option from the 
command and retry. 


TRANS33 Only one of TRACKS, CYLINDERS, 
AVBLOCK allowed: file transfer 
canceled 


Explanation: SPACE can be specified in 
units of either TRACKS, CYLINDERS, or 
AVBLOCK. Only one can be used. 


User Response: Remove the unwanted 
option from the command and retry. 


TRANS34 CMS file not found: file transfer 


canceled 


Explanation: An existing CMS file must be 
specified for RECEIVE. 


User Response: Correct the CMS file specifi- 
cation in the command and retry. 


TRANS35 CMS disk is Read-Only: file transfer 
canceled 


Explanation: The CMS file mode specified 
for SEND must allow write access. 


User Response: Correct the CMS file specifi- 
cation in the command and retry. 


TRANS36 CMS disk is not accessed: file 


transfer canceled 


Explanation: The CMS file mode is not in 
the CMS disk search order. 


User Response: Access the required disk in 
CMS or correct the CMS file specification in 
the command. Retry the command. 
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TRANS37 CMS disk is full: file transfer 


canceled 


Explanation: Either the CMS disk is full, 
the maximum number of files (3400) on the 
minidisk has been reached, or the maximum 
number of data blocks (16060) per file has 
been reached. 


User Response: Use another disk with 
enough space or remove unwanted files from 
the specified disk. If the personal computer 
file is very large (over 1 M bytes), consider 
dividing it into several pieces. Retry the 
command. 


TRANS99_ Host program error code XX 


XXXXXXX: file transfer canceled 


Explanation: This message indicates a 
program error. 


User Response: Follow your local proce- 
dures and have available: 


1. Sequence of events 


2. The variable data (KX XXXXXXX) 
from the TRANS99 message 


3. The system level 


Work Station Control Messages 
(WSnnn) 


WS001 No recording with this name exists: 
Press List (PF 1) 


Explanation: During an autokey play or 
erase operation, the recording name entered 
did not match any names already in the 
recording directory. 


User Response: Check the recording name 
and reenter the correct name. 


WS002 Incorrect key pressed 
Explanation: You pressed an incorrect key. 


User Response: Check your information and 
retry. 


WS003 The window is currently busy 


Explanation: An internal function is cur- 
rently active in the window. 


User Response: Wait for the internal func- 
tion to finish. For example, wait for the 

x <¢ I to disappear before retrying the 
operation. 


WS004 Duplicate name entered: Choose a 
unique name 


Explanation: During a recording procedure, 
you entered a recording name that had an 
exact duplicate in the autokey directory. 
Each recording name must be unique. 


User Response: Choose a unique recording 
name. 
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WS005 Recording space full: cannot record 


Explanation: You attempted to start a 
recording when no free recording space was 
available for the record. The session cannot 
be started. 


User Response: Use List to examine the list 
of current recordings and erase those no 
longer needed. Retry the record operation. 


WS006 Cannot move the window further 


Explanation: While in Move, the window 
has been moved to the edge of the physical 
screen. It cannot be moved off the screen. 


User Response: Do not try to move the 
window any farther in that direction. 


WS007 Wrong key or incorrect character 
entered 


Explanation: While in work station control 
mode, you attempted to do a function with a 
window ID that was not valid. 


User Response: Try to do the function with 
a valid window ID. 


WS008 Cannot shrink the window further 


Explanation: While in Size, you attempted 
to shrink the selected window to less than a 
one-character-by-one-character window size. 


User Response: Do not try to shrink the 
window farther. 


WS009 Cannot expand the window further 


Explanation: While in Size, you attempted 
to enlarge the window larger than allowed. 


User Response: Do not try to enlarge the 
window farther. 


WS010 Window reached edge of Presentation 
Space 


Explanation: While in Browse, you tried to 
browse past the edge of the presentation 
space. 


User Response: Do not try to browse in 
that direction any farther. 


WS011 Cannot size a window while enlarged 


Explanation: You have enlarged a window. 
You cannot size it at this time. 


User Response: If you want to size the win- 
dow, press Enlarge to return to the original 
window size. Now you can size the window. 


WS012 Cannot Play or Record: Playing or 
Recording in progress 


Explanation: The active application already 
has a recording or play in progress. Another 
cannot be started until that autokey session 
has ended. 


User Response: Press Quit to cancel the 
autokey session. If you are recording, enter 
application mode and press Finish to end 
the recording. 


WS013 Copy not allowed: Source and Target 
are not defined 


Explanation: You attempted a copy opera- 
tion by pressing Enter, but you have not 
defined both your source and target. 


User Response: Define both your source 


and target at this time and then press Enter 
to perform the copy operation. 
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WS014 Source and Target are not the same size 


Explanation: The source area defined is 
either larger or smaller than the target area 
defined. 


User Response: 


1. You can press PF13 (Source) and/or 
PF 14 (Target), to redefine your source 
and target, making them both the same 
size or 


2. You can continue with the copy opera- 
tion by pressing Enter. If you allow the 
copy operation to complete: 


a. And the source is larger than the 
target, truncation occurs. 


b. And the source is smaller than the 
target, the target area is padded 
with blanks. 


WS015 Warning: List must be removed to 


continue most WS Ctrl work 


Explanation: While List appears on your 
screen, you cannot perform most work in 
work station control mode. 


User Response: If you want to do more 
work, press PF 1 to remove List. 


WS016 Warning: Copy did not occur. Target is 


protected 


Explanation: You tried to copy into a target 
area that is protected. 


User Response: Redefine your target area 
and retry. 


WS025 Cannot add another window: Maximum 
number reached 


Explanation: The maximum number of 
windows has been added to the system. 


User Response: If you want to add more 
windows, you will need to delete those that 
are unnecessary to make room for the 
windows you want to add. 


WS026 Cannot add or delete window on Screen 
Profile 0 


Explanation: Screen Profile 0 was created 
when you customized your work station. 
You cannot add windows to or delete win- 
dows from Screen Profile 0 during normal 
operation. This message may also occur if 
you begin typing data while in work station 
control mode. 
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User Response: Verify that you are in the 
proper mode and do not try to add or delete 
windows from Screen Profile 0. 


WS027 All other windows are hidden: Next 


window is now visible 


Explanation: When you performed a Hide, 
all other windows for that screen profile 
were already hidden, forcing the previously 
active window to become visible. At least 
one window will always be visible on a 
defined screen profile. 


User Response: Make sure at least one win- 
dow is visible before hiding another if you 
do not want the system to make one visible. 


WS029 Color setting override: Changes may 


not show 


Explanation: Although your changes were 
made, the selected window is currently 
receiving instructions to ignore the selected 
settings. The colors appear after the window 
stops receiving instructions to ignore them. 


User Response: Your color changes have 
taken effect. Go to your next operation. For 
more information on color, see Chapter 7. 


WS030 Foreground and background colors are 


the same 


Explanation: The foreground and back- 
ground colors of the selected windows are 
identical. This causes your typed characters 
to be invisible. 


User Response: This is a warning message. 
If you want to be able to see the characters 
in this window, change either the foreground 
or the background to a different color. 


WS031 Cannot set color: No color display 


Explanation: You do not have a color dis- 
play. You cannot use the color function. 


User Response: Do not try to use the color 
function. If you have a color display and 
this message appears, see the system check- 
out procedures in the JBM 3270 Personal 
Computer Guide to Operations. 


WS033 Cannot use Auto on undefined Screen 
Profile 


Explanation: You tried to perform autokey 
functions while using an undefined screen 
profile. 


User Response: Select a defined screen 
profile. 


WS034 Cannot set color for a Personal 
Computer window 


Explanation: The selected window was the 
personal computer window. Color for the 
personal computer window cannot be set in 
work station control mode. 


User Response: Do not try to use the color 
function in the personal computer window. 


WS035 Correct the name and press enter 


Explanation: The name you entered was all 
blanks. 


User Response: Try a valid name and press 
Enter. 


WS036 Cannot leave WS Ctrl mode: No availa- 
ble windows 


Explanation: You pressed WS Ctrl while in 


work station control mode with an undefined 
screen profile selected. 
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User Response: Either change to a defined 
screen profile or add a window to the unde- 
fined screen profile. 


WS037 Cannot delete recording: Record or Play 
in progress 


Explanation: A record or play operation is 
already in progress. This stops the delete 
operation. 


User Response: End any recording or play 
sessions currently active on all windows be- 
fore attempting to retry the delete function. 
You can examine all windows on Screen Pro- 
file 0 to find which have autokey active. In 
work station control mode, the operator 
information area indicates record or play 
while you select the window. 


WS038 Cannot begin another recording: 
Recording already in progress 


Explanation: There is a recording session 
already active on some screen or window 
other than the one currently active. 


User Response: End the first recording 
session before attempting another record- 
ing. You can examine all windows on Screen 
Profile 0 to find which one is recording by 
looking for REC in the work station control 
operator information area. 


WS039 Cannot jump to another window : None 
are visible 


Explanation: Either this window is the only 
one on this screen profile or all other windows 
are hidden. This message appears only in 
work station control mode. 


User Response: Either make more windows 
available or do not use the jump function. 
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WS040 Cannot use ChgSc: All other screens are 
empty 


Explanation: The only defined screen profile 
is Screen Profile 0. This message appears 
only in work station control mode. 

User Response: Either define more screen 
profiles or do not use the change screen 
(ChgSc) function. 


WS041_ Printing in progress: Retry when print- 
ing is complete 


Explanation: A print request is already in 
progress. 


User Response: Wait for the print to finish. 
If the printing does not complete, perform 
system checkout for the printer as detailed 
in the IBM 3270 Personal Computer Guide 
to Operations. 

WS042 Print screen canceled by user 


Explanation: You pressed the Quit key, 
canceling the current print operation. 


User Response: None. 
WS043 Print screen canceled: Printer not ready 


Explanation: The printer is not ready, so 
the print operation is canceled. 


User Response: If possible, check for reasons 
the printer is not ready. 


@ The printer may be out of paper 
@® The printer may not be turned on 


@ There may be a problem with the cable 
to the printer. 


Using Messages E-59 


Check and correct the conditions and retry 
the operation. If the failure persists, per- 
form system checkout for the printer as de- 
tailed in the IBM 3270 Personal Computer 
Guide to Operations. 


WS045 Selected source not allowed 


Explanation: The selected source window 
for the copy function is not a host, personal 
computer, or notepad window, or the per- 
sonal computer session is in graphics mode. 


User Response: Press Finish to return to 
Copy and select the correct source window. 


WS046 Selected target not allowed 


Explanation: The selected target window 
for the copy function is not a host or note- 
pad window. 


User Response: Press Finish to return to 
Copy and select the correct source window. 


WS047 Warning: Overlapping Source and 
Target areas 


Explanation: The source and target areas 
overlap. Only the area defined first will be 
highlighted. 


User Response: 


@ You may proceed with the copy func- 
tion to copy the original contents of the 
source area into the target area by 
pressing Enter or 


@® Go back to Source by pressing PF13, or 


to Target by pressing PF14 and redefine 
the source or target. 
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WS048 Copy not allowed: Input inhibited in 
Target window 


Explanation: You attempted a copy opera- 
tion while the keyboard was in an input in- 
hibited state for the selected target window. 


User Response: 


Wait for the keyboard to “‘unlock.”’ 
Verify that your target is correct. 
Press Enter. 

Verify that the host is operating. 


re 


If the keyboard remains locked, refer to Ap- 
pendix B to isolate the cause of the failure. 
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Notes: 


Introduction 


Any of the Save and Restore commands (Chap- 
ter 11), Send and Receive commands (Chapter 
13), IBM Personal Computer DOS commands, or 
user-written commands (see the IBM Personal 
Computer Disk Operating System manual) can 
be stored as records in special DOS files called 
batch files, whose file extension is .BAT. Each 
record in the file is a command, and the sequence 
of such commands is called a command proce- 
dure. Records stored in such a filename.BAT file 
may include any of the commands mentioned 
above. 


The commands stored in a filename.BAT file can 
be invoked by typing 


filename 
in the personal computer window. 
This appendix will show you how to create vari- 


ous kinds of command procedures for the Save, 
Restore, Send, and Receive commands. 
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Suppose you want to set up your IBM 3270 Per- 
sonal Computer periodically for a particular 
application and need to: 


@® Restore a set of screen profiles from 
APPL1.SCR 


@ Restore a set of autokey recordings from 
APPL1.REC 


@ Restore a set of notepads from 
APPLI.NOT. 


Instead of entering three individual Restore 
commands and having to remember three user 
filenames, you can set up a command procedure, 
such as CONFIG1.BAT, that contains the three 
commands. Then you need only enter a single 
word to cause the three commands to be exe- 
cuted. This is illustrated below: 


A> 
COMNFIGI1 


CONFIG1.BAT file 


INDRSTR SCREEN APPL1.SCR 


INDRSTR RECORD APPLI.REC 


INDRSTR NOTEPAD APPL1.NOT 


Creating an Autoexec.Bat 


Besides using command procedures to prepare 
the IBM 3270 Personal Computer quickly for 

a particular application, most users will have 

a special command procedure named 
AUTOEXEC.BAT. This file initially contains a 
statement that the system supplies at the con- 
clusion of the customization task. Do not alter 
or remove this name. You may include other 
desired commands as long as they follow the 
statement that the system supplies. 


If you build such a file, it is invoked automati- 
cally any time DOS is initialized, causing the 
commands in AUTOEXEC.BAT to be executed. 
By putting the appropriate Restore commands 
into the AUTOEXEC.BAT file with other de- 
sired commands, you can set up the IBM 3270 
Personal Computer with standard screen pro- 
files, autokey recordings, and notepads whenever 
DOS is initialized. 


DOS initialization occurs automatically when- 
ever the customized system diskette is loaded 
and initialized. Also, when the personal com- 
puter window is active and in application mode, 
you can reinitialize DOS at any time by pressing 
the following key sequence: 


Alt + Ctl + Del 


AUTOEXEC.BAT or other command procedure 
files can be created by use of the EDLIN editor 

supplied with DOS (see the IBM Personal Com- 
puter Disk Operating System manual) or any of 
the other file editors available for the IBM Per- 

sonal Computer. 
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Procedures 
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A special programmed command procedure can 
be created to quickly recall a series of notepads 
previously saved. This technique requires that 
the user write a DOS command program (BASIC 
or other language) to interface with the operator. 
The program can prompt the operator to press 
certain keys to page forward or backward 
through notepad screens, or ask for the ‘‘name’”’ 
of a particular notepad screen to be restored. 
The operator program, after receiving input 
about which notepad to restore next, converts 
this into an INDRSTR (Restore) command 
record with the correct notepad filename. The op- 
erator program then writes this new INDRSTR 
record to the disk to overlay an existing INDR- 
STR command record contained in the command 
procedure file. This file also contains a command 
that invokes the operator program itself. If a 
Loop command is put into this file as well, a pro- 
grammed command procedure, controlled by 
operator input, is created. This is illustrated 
below: 


A> 


OTE——» NOTE.BAT SELECT.COM 
CALL RETURN 


SELECT 1. REQUEST INPUT 


DISK WRITE 


INDRSTR (filename) |™ 2. REWRITE INDRSTR 


3. RETURN 


When NOTE.BAT is invoked, it first calls the 
SELECT.COM operator program. The operator 
program requests input that indicates which 
notepad record is to be restored next. This input 
is converted into an INDRSTR command record 
with the correct notepad filename. This record is 
written into the NOTE.BAT file to overlay the 
existing INDRSTR record. The SELECT.COM 


program then returns. This causes the next com- 
mand, INDRSTR, which was just created, to be 
executed. When this command has finished re- 
storing the notepad, the next command, LOOP, 
is executed, causing the SELECT command to 
be invoked again. This starts the cycle over 
again, with new operator input into the 
SELECT.COM operator program. 


A related series of notepads can be created and 
their filenames stored in a control file along with 
a ‘current notepad” pointer. This control file can 
be accessed by the operator program to step 
through the related notepads, using the pointer. 
Single keys can then be used to cause the 
operator program to step forward or backward 
through the related notepad file names to 
quickly restore them. The notepads can be used 
for operator viewing or, for example, as a source 
for copying saved data into 3270 edit screens for 
document creation. The following illustrates the 
control file concept: 


NOTE.BAT CALL SELECT.COM CONTROL.FIL 
RETURN DISK 


LOOP 


SELECT 
INDRSTR (filename) 


1, ‘ADVANCE’ KEY 


. READ CURRENT 
POINTER 
. INCREMENT 


NOTEA.001 


. WRITE CURRENT NOTEA.002 
POINTER 
. READ NOTEA.003 


CURRENT 
POINTER 


NOTEA.003 


. REWRITE INDRSTR NOTEB.002 


. RETURN 


NOTEB.003 


NOTEB,004 


NOTEB.005 
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The SELECT.COM program reads an operator 
keystroke indicating advance to the next related 
notepad. The current pointer in the control file is 
read and updated. The filename of the notepad 
being pointed to, NOTEA.008, is read in from 
the control file and used to build a new 
INDRSTR command record. This record is 
written into the NOTE.BAT file. SELECT.COM 
returns, and NOTEA.008 is restored by the 
INDRSTR command for operator viewing or 
other uses. 


Many variations of the illustrated programmed 
command procedure can be developed to allow 
program control, not only of notepad Save and 
Restore, but also of screen profiles or autokey 
Save and Restore. In addition, similar tech- 
niques can be used to control file transfer com- 
mands (see the next section), IBM Personal 
Computer DOS commands, or other user-written 
commands. 


File Transfer Command 
Procedures 
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The file transfer commands described in Chapter 
13 can be entered directly from the keyboard or 
invoked indirectly by use of standard or pro- 
grammed command procedures. Such command 
procedures can shield the operator from remem- 
bering the complex parameters required when 
directly entering Send or Receive commands. 


For example, a general programmed command 
procedure can be user-written. An operator 
interface program will prompt for simplified file- 
names and convert these into the required pa- 
rameters for multiple Send or Receive opera- 
tions. This is illustrated below: 


A> 


FILE——-» FILE.BAT FILEFIND.COM 
CALL RETURN 


DISK WRITE 


FILEFIND . OPERATOR INPUTS 
SIMPLIFIED FILE 

IDs 

. REWRITE SEND OR 
RECEIVE COMMAND 


. RETURN 


SEND/RECEIVE... 


LOOP 


—_ 


Refer to “‘Programmed Command Procedures’’ 
in this appendix for a more detailed discussion of 
this technique. 


Another option is to set up fixed command pro- 
cedures that transfer multiple files to and from 
the host by typing in a single command, as 
shown below: 


A> 
FILESET1 —___—_—__—» FILESET1.BAT file 


SEND MEMO.001. . . 

SEND MEMO.002.. . | 
RECEIVE MEMO.001. . | 
RECEIVE MEMO.002. . . 
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Such procedures, and others like it, can be used 
to provide central host storage, control, and dis- 
tribution of files within a network of IBM 3270 
Personal Computers. This concept and the types 
of files and procedures that can be distributed 
are illustrated as follows: 


IBM 3270 
PERSONAL COMPUTER 
FILES 


e CUSTOMIZATION 
INFORMATION 


®PATCHES 


IBM 3270 


PERSONAL VM or TSO @® SCREEN PROFILE SETS 


HOST 


COMPUTER 


@ AUTOKEY SETS 


@ NOTEPAD SETS 


® COMMAND PROCEDURES 
— FILE TRANSFER 
— SAVE/RESTORE 


NETWORK 


IBM 3270 IBM 3270 IBM 3270 IBM 3270 
PERSONAL PERSONAL PERSONAL PERSONAL 
COMPUTER COMPUTER COMPUTER COMPUTER 
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This appendix is for anyone who needs technical 
information about 


@® 3270 limitations 
@ 3270 data stream functions 
@® Mandatory card slot assignments inside the 
system unit 
@ Personal computer application mode 
operation 
Limitations 


The following 3270 capabilities are limited or 
are not available with the IBM 3270 Personal 
Computer: | 


The magnetic slot reader, magnetic hand 
scanner, and selector light pen are not avail- 
able as attachments. 


Port 0 of the 3274 Control Unit attachment 
is available in control unit terminal (CUT) 
mode only. 


The binary synchronous copy command is 
not available. 


The security keylock is not available. 


Alert is not supported on the distributed 
function terminal (DFT) session. 


Explicit partition is not supported on the 
distributed function terminal (DFT) session. 


@ The 3274 entry assist feature is not 
available. 


The APL character set is not available. 


Encryption/decryption is available for con- 
trol unit terminal (CUT) only. 


The 3270 numeric lock is not supported. 
The 3270 graphic escape is not supported. 


Video output is not supported. 


The diagnostic reset dump to the 3274 Con- 
trol Unit is not supported. 


The response time monitor is not supported 
on the distributed function terminal (DFT) 
session. 


3270 Data Stream Functions 


This section describes the 3270 data stream 
functions supported by the IBM 3270 Personal 
Computer For general information on all the 
3270 data stream functions, refer to the [BM 
3270 Information Display System: Data Stream 
Programmer’s Reference, GA23-0059. 


In this section, those functions of the 3270 data 
stream that are supported by the IBM 3270 Per- 
sonal Computer are listed and any information 
unique to IBM 3270 Personal Computer is pro- 
vided. For those familiar with the 3270 data 
stream, this information should be sufficient for 
most purposes. 
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Interface Codes 


Data commands and orders transmitted between 
the IBM 3270 Personal Computer and the host 
system are in the form of extended binary-coded 
decimal interchange code (EBCDIC) interface 
codes. Table G-1 shows the interface codes. Refer 
to IBM 8270 Information Display System: Char- 
acter Set Reference, GA27-2837, for further 
details. Table G-2 lists the EBCDIC control 
character I/O codes. 


Table G-1. United States EBCDIC I/O Interface Code 


-“ 
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Notes to Table G-1 


Codes X‘00’ through X‘IF’ and X‘FF’ are control codes, and codes X‘40’ through X‘FE’ are character codes. All blank squares in this chart 
represent undefined codes. All defined character codes are enclosed by heavy lines. Undefined control codes are rejected with a negative response 
(SNA) or an Op Check (non-SNA). If the extended attribute buffer (EAB) is enabled, all undefined character codes are accepted, stored, and 
returned without change on a subsequent read operation. If the EAB is disabled, character codes X‘CE’, X‘CF’, X‘DD’, X‘DE’, X‘EE’, X‘EF’, 
and X‘FE’ are stored, displayed, and returned as the character (X‘60’) and all other undefined character codes are accepted, stored, and returned 
without change. IBM reserves the right to change at any time the character displayed or printed and the I/O interface code returned for an 


undefined character code. 


CR, NL, EM, and FF control characters are displayed and printed as spaces. If extended attributes are not enabled, the DUP and FM control 
characters are respectively displayed as » and ; in dual-case mode and as » and ; in monocase mode. If extended attributes are enabled, DUP and 
FM are always displayed as % and ; respectively. DUP and FM are always printed as » and ; respectively. 


Bits 0 and | are assigned for the following characters: AID, attribute, write control (WCC), device address, buffer address, sense, and status. Bits 
0 and | are assigned so that each character can be represented by a graphic character within the solid outlined areas of the chart. See Table G-2. 


During monocase mode, the lowercase alphabetic characters are displayed or printed as uppercase characters. 


Table G-2. EBCDIC Control Character I/O Codes 


Graphic 


SP 
A 
B 
C 
D 
E 
F 
G 
H 
I 
a 


DOUVOAZSORUS 4 7A 


a 


~— 


Graphic 


10 0000 |. 

10 0001 | / 

10 0010 |S E2 
10 0011 | T E3 
10 0100 | U E4 
10 0101 | V E5 
10 0110 | W E6 
10 O111 | X E7 
10 1000 | Y E8 
10 1001 | Z E9 
10 1010 6A 
LO) “OEE: ult 6B 
10 1100 | T 6C 
10 1101 6D 
10:. ALLO® |) = 6E 
10 1111 | ? 6F 
11 0000 | 0 FO 
11 0001 | 1 Fl 
11 0010 | 2 F2 
11 0011 | 3 F3 
11 0100 | 4 F4 
11 0101 | 5 F5 
11 0110 | 6 F6 
i M6 gh WM F7 
11 1000 | 8 F8 
11 1001 | 9 F9 
11 1010 |: TA 
11 1011 | # 7B 
11 1100 | - 7C 
11 1101 7D 
11 1110 | = 7E 
Lt DEEL oe 7F 
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Notes to Table G-2 


1. The characters in table G-2 are used as attribute, AID, 
write control (WCC), CU and device address, and buffer 
address. 


2. Touse this table to determine the hexadecimal code trans- 
mitted for an address or control character, first determine 
the values of bits 2-7. Select this bit configuration from 
the Bits 2-7 column. The hexadecimal code that will be 
transmitted is to the right of the bit configuration. 


3. Use this table also to determine equivalent EBCDIC hex 
codes and their associated graphic characters. Graphic 
characters for the United States I/O interface codes are 
shown. Graphic characters might differ for particular 
World Trade I/O interface codes. For possible graphic 
differences when these codes are used, refer to JBM 38270 
Information Display System: Character Set Reference, 
GA27-2837. 


Attributes 


The IBM 3270 Personal Computer display sta- 
tion supports field attributes, extended field 
attributes, and character attributes. 


Field Attributes 


Table G-3 shows the field attribute byte and the 


bit assignments for the field attributes sup- 
ported by the IBM 3270 Personal Computer. 


Table G-3. Field Attribute Character Bit Assignment 


x L | UIP | A/N | D/SPD | o| MDT Field Attribute Byte 
0 1 2 | 3 4 5 | 6 | iT Bit Positions 
EBCDIC 
Bit Field Description 
= aeons 
0 Value determined by contents of bits 2-7. See Table G-2 
for hexadecimal values. 
I Always 1 
2 0 = Unprotected 
1 = Protected (see Note) 
3 0 = Alphanumeric 
1 = Numeric (if numeric lock capability is activated, 
causes automatic numeric shift of keyboard) 
(see Note) 
4,5 00 = Display not detectable by Cursor Select key 
01 = Display detectable by Cursor Select key 
10 = Intensified display detectable by Cursor Select 
key 
11 = Nondisplay, nonprint, nondetectable 
6 Reserved — Always 0. 
7 Modified data tag (MDT); identifies modified fields 
during Read Modified command operation 
0 = Field has not been modified. 
1 = Field has been modified by the operator. Can also 
be set by program in data stream. 


za 


Note: Bits 2 and 3 equal to 11 causes an automatic skip. 
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Extended Field Attributes and Character 


Attributes 


The IBM 3270 Personal Computer supports the 
attribute types and attribute values in Tables 
G-4, G-5, and G-6 as extended field attributes 
(EFAs) and as character attributes (CAs). All 
other attribute types and attribute values are 
rejected with a negative response (SNA) or an 
Op Check (non-SNA). 


Table G-4. Attribute Type X‘41’ - Extended 


Highlighting 
Attribute 
Value (Hex) | EFA 
00 Default 
Fl Blink 
F2 Reverse video 
F4 Underscore 


—— 


paren Gree 


CA 


Default (to EFA) 
Blink 

Reverse video 
Underscore 


re ne Pr en Va) ER et Ene 


Table G-5. Attribute Type X‘42’ - Color 


Attribute 
Value (Hex) | EFA CA 
| | 
00 Default Default (to EFA) 
Fl Blue Blue 
F2 Red Red 
F3 Pink Pink 
F4 Green Green 
F5 Turquoise Turquoise 
F6 Yellow Yellow 
F7 White White 
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Table G-6. Attribute Type X‘43’ - Character Set 


Attribute 
Value (Hex)|} EFA 


Selection 


Default 
Reserved 
PSA 
PSB 

PSC 
PSD 
PSE 

PSF 


LCID 
CA Default 
Default (to EFA) 
APL-Text 
PSA FF 
PSB FF 
PSC FF 
PSD FF 
PSE FF 
PSF FF 
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Commands 


For a description of the functions of the follow- 
‘ing commands, see the [BM 3270 Information 
Display System: 3274 Control Unit Description 


and Programmer’s Guide, GA23-0061. 


3270 Data Stream Commands 


The 3274 Control Unit internally translates the 
non-SNA channel command codes into the SNA/ 
BSC form before transmitting this information 


to the IBM 3270 Personal Computer. 


Table G-7 shows these commands. 


Table G-7. 3270 Data Stream Commands 


i ee 


Command 


Mnemonic 


Write 

Erase/Write EW 

Erase/Write EWA 
Alternate 

Write Structured WSF 
Field 

Erase All EAU 
Unprotected 

Read Buffer RB 

Read Modified RM 


Read Modified All 


Command Code-EBCDIC (Hex) | 


SNA/BSC | Non-SNA Channel 


F5 
7E 


F3 
6F 
F2 


F6 
6E 


Non-SNA Channel Commands 


Although not part of the 3270 data stream, the 
channel commands in Table G-8 are valid for 
non-SNA channel-attached IBM 3270 Personal 
Computer display stations. The 3274 Control 
Unit internally decodes the following commands 
and passes the appropriate Write, Read Modi- 
fied, or Read Buffer SNA/BSC command code 
values to the IBM 3270 Personal Computer. 


Table G-8. Non-SNA Channel Commands 


Command Mnemonic 


| Non-SNA Channel Command 


Code-EBCDIC (Hex) 


Sense 


No Operation 


Select Read Modified | Select RM 

Select Read Buffer Select RB 

Select Read Modified | Select RMP 
from Position 

Select Read Buffer Select RBP 
from Position 

Select Write 
L_ 


————1 


Select ee 


03 | 
04 


3B 
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Write Control Character 
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The write control character (WCC) bits have the 
following significance for the IBM 3270 Personal 
Computer: 


WCC 

Bit Explanation 

0 No function. 

1 No function for the WRT command. Re- 


set function, if set to 1, for EW and 
EWA commands. See Table G-9 for the 
effects of the reset function when the 
IBM 3270 Personal Computer is in im- 
plicit partition state. 


F283 Reserved 


4 Start printer (SNA only). When set to 1, 
initiates a local-copy operation at the 
completion of the write operation. If no 
printer is available, a negative response 
X‘0801’, X‘082E’, or X‘082F’ is re- 
turned. 


5 Sound alarm. When set to 1, causes the 
audible alarm to sound. 


6 Keyboard restore. When set to 1, 
causes keyboard operation to be re- 
stored (by resetting system lock or 
WAIT indicator) and resets AID byte 
to X‘60’. 


ir Reset MDT bits in field attributes 
(WRT command only). When set to 1, 
causes MDT bits to be reset to 0 in all 
field attribute bytes in the specified 
partition, before any orders or data 
characters are processed. 


Table G-9. Write Control Character Reset Actions 


Reset Condition 


1. WCC following Erase/Write or 
an Erase/Write Alternate 
command. 


a. WCC = Reset. 


b. WCC = No reset. 


2. WCC following a Write 


command. 


a. WCC = Reset or no reset. 


38. WCC in outbound 3270DS 
header, and the function is 
Erase/Write or Erase/Write 
Alternate. 


a. WCC = Reset. 


b. WCC = No reset. 


4. WCC in outbound 3270DS 
header, and the function is 
Write. 


a. WCC = Reset or no reset. 


Implicit Partition State 


Execute the command; reset the 
inbound reply mode to field. 


Execute the command. 


Execute the command. 


If the PID equals 0, execute the 
function (except for screen-size 
changes) and reset the inbound 
reply mode to field. If the PID 
does not equal 0, reject with 
negative RSP. 


If the PID equals 0, execute the 
function. If the PID does not 
equal 0, reject with RSP. 


Execute the function if the PID 
equals 0; otherwise, reject with 
negative RSP. 
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3270 Data Stream Orders 


The IBM 3270 Personal Computer supports the 
following 3270 data stream orders. Table G-10 
lists these orders. 


Table G-10. Data Stream Orders 


Order Code | 
} Onder Mnemonic EBCDIC (Hex) 

Start Field SF 1D 
Start Field Extended’ | SFE 29 
Set Buffer Address SBA 11 
Set Attribute’ SA 28 
Modify Field’ MF 2C 
Insert Cursor IC 12 
Program Tab PT 05 
Repeat to Address RA 3C 
Erase Unprotected 

to Address EUA 12 


‘The SFE, SA, and MF orders are valid only when the 
extended attribute buffer (EAB) is enabled for the logical 
terminal to which the order is directed. When the EAB is 
not enabled, these orders are rejected with a negative 
response (SNA) or an Op Check (non-SNA). 
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Outbound 3270 Data Stream 
Structured Fields 


The Write Structured Field (WSF) command 
(X‘F3’) is used by the host program to transmit 
the following outbound structured fields to the 
addressed logical terminal in the in-selection 
logical-terminal set. 


ID Code 
Outbound Structured Field (EBCDIC-Hex) 
Set Reply Mode 09 
Erase/ Reset 03 
Outbound 3270DS 40 
Write F1 
Erase/Write F5 
Erase/Write Alternate TE 
Erase All Unprotected 6F 
Read Partition 01 
Read Buffer F2 
Read Modified F6 
Read Modified All (SNA 6E 
only) 
Query 02 


All other structured-field ID codes are rejected 
with a negative response (SNA) or an Op Check 
(non-SNA). 
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Set Reply Mode Structured Field Format 


The set reply mode structured field specifies the 
reply mode required in all subsequent inbound 
data streams. The specified reply mode remains 
in effect until it is changed by one of the 
following: 


@ Another set reply mode structured field, 
specifying a different reply mode 

@® Anerase/reset structured field 

@ An EW or EWA command or a structured 
field with the WCC bit 1 set to 1, causing a 
reset function. 


Table G-11 shows the content and meaning for 
bytes 0-5 and 7. 


Table G-11. Set Reply Mode Structured Field Format 


| 
Byte Content 


— 


eae k 
Length of structured field in bytes 


Partition identifier (must be X‘00’ for 
implicit partition state) X‘00’-X‘OF’ 


Character mode 


Highlighting selection (Notes 1, 2, and 3) 


Meaning 

0,1 X‘0005’ 
through 
X‘0008’ 

2 X‘09’ ID code of set reply mode 

3 PID 

4 Reply mode requested 
X‘00’ Field mode (default) 
X‘01’ Extended field mode 
X‘02’ 

5 X‘41’ 

7 X‘42’ 

Notes: 


Color selection (Notes 1, 2, and 3) 


1. More than 5 bytes can be present only when character 
mode (X‘02’) is requested. Only when the length code is 
greater than X‘0005’ can the operator select from the key- 
board the attribute value to be associated with the keyed 
data as shown in byte 5 above. 


2.  Ifcolor selection (X‘42’) is specified, the structured field is 
accepted, but the operator is not allowed to select color 
attributes from the keyboard. 


3. ‘41’, and X‘42’, can appear in any order, not necessarily 
as shown in bytes 5 and 7 above. 
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Erase/Reset Structured Field Format 
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The erase/reset structured field creates an im- 
plicit partition 0 of default or alternate size, as 
specified in the structured field. Inbound-reply 
mode is reset. Table G-12 shows the content and 
meaning for bytes 0-3. 


Table G-12. Erase/Reset Structured Field Format 


_ 
Byte | Content 


Meaning 


lo, 1 


etree Length of structured field 


in bytes 
lo X03" Erase/Reset ID code 
3 Size Size of usable area: 7] 
X‘00’ Default size 
X‘80’ Alternate size 


If byte 3 contains any value other than X‘00’ 
or X‘80’, the structured field is rejected with 
a negative response (SNA) or an Op Check 

(non-SNA). 


Outbound 3270DS Structured Field Format 


The outbound 3270DS structured field is used to 
direct the write commands to a specified parti- 
tion. The write commands are: 


@® Write 

@ Erase/Write 

@ Erase/Write Alternate 
@® Erase All Unprotected. 


Table G-13 lists the content and meaning for this 
structured field. 


Table G-13. Outbound 3270DS Structured Field 


Byte | Content Meaning 
beta _ 
| 9 1 L Length of structured field in bytes 
at 
2 X‘40’ Outbound 3270DS ID code 7 


Partition identifier 


X‘F 1’ Write 

X‘F5’ Erase/Write 

X‘7TE’ Erase/Write Alternate 
X‘6F’ Erase All Unprotected 


L 
The remaining bytes of the structured field are the same 
as for the specified Write command. 


WCC bit 1 set to 1 does not reset the IBM 3270 
Personal Computer to implicit partition state, as 
it does for the non-structured-field command, 
but resets the reply mode of the inbound parti- 
tion to field mode. WCC bit 4 set to 1 specifies 
Start Print and must be in the last structured 
field of the string of structured fields. 
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Read Partition Structured Field Format 
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Table G-14 describes the content and meaning 
for the read partition structured field. 


Table G-14. Read Partition Structured Field Format 


ifs ; 
Bye Content | Meaning 


ea a 

0,1 X‘0000’ | Length of structured field in bytes 
X‘0005’ 

2 X‘01’ Read-partition ID code 

3 PID Partition identifier 


X‘00’ - X‘OF’: read operations 
X‘FF’ (physical terminal): query 
operations 


4 Type 
X02’ Query (used in both implicit partition 
and explicit partitioned states) 

X‘6E’ Read Modified All (RMA) 

X‘F 2’ Read Buffer (RB) 

X‘F6’ Read Modified (RM) 


Restrictions: 


1. Must be the last structured field in the current out- 
bound transmission. 


2; IBM 3270 Personal Computer must be in normal-read 
state, and PID must specify a valid partition. 


Any of the following conditions causes an error 
and the return of an appropriate sense code in 
SNA or of Op-Check in non-SNA: 


@® The IBM 3270 Personal Computer display is 
in normal-read state, and the identified par- 
tition does not exist; sense code X‘1005’. 
The command code is invalid; sense code 
X‘1003’. 

The PID value is invalid; sense code 
X‘1005’. 


@® The read-partition function is not the last 
structured field to be sent in the current 
outbound transmission; sense code X‘1005’. 

@ The IBM 3270 Personal Computer is in re- 
try state; sense code X‘0871’. 

The transmission is sent with end bracket; 
sense code X‘0829’. 

The transmission does not specify ‘‘Change 
Direction’’; sense code X‘0829’. 


Inbound 3270 Data Stream 


All inbound 3270 data streams are preceded by 
an attention identifier (AID) byte that identifies 
the cause of the inbound transmissions. Table G- 
15 lists the possible causes of an inbound 3270 
data stream, the associated AID values, and the 
resulting operations when the IBM 3270 Per- 
sonal Computer is in normal-read state or in 
retry state. 


Table G-15. Inbound 3270 Data Stream 


= 
Ke = Operation (Normal- Operation 

Cause AID Read State) (Retry State) 
= eas =] 

Clear key X‘6D’ Short read (implicit 

partition 0) 

PA1 key X‘6C’ Short read 

PA2 key X‘6E’ Short read 
| PA8 key aa 6B Short read =f 

PF1-PF9 keys X‘F1’-X‘F9’ Read modified 

PF10-PF12 X‘TA’-X'7C’ (addresses and data 

keys of all modified 

PF13-PF21 X‘C1’-X‘C9’ fields—nulls 

keys suppressed) 

PF22-PF24 X‘4A’-X‘4C’ 

keys 

Cursor-select X‘7D’ 

field with & 

designator or 

Enter key 
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Table G-15. Inbound 3270 Data Stream (continued) 


Operation (Normal- NM @penation | 
Cause AID | stead State) (Retry State) 
r 1 
Read X‘60’ Read modified Retry last 
AID 
Modified action from 
command inbound 
as i" partition | 
Read X‘60’ | Read modified all Retry read 
Modified All modified all 
command from inbound 
partition 
r Read Buffer x60" Read buffer Retry read 
command buffer from 
inbound 
partition 
Read X‘61’ Read modified Reject 
Partition . 
Modified-SF 
FS T i 1 
Read X‘61’ Read modified all Negative Re- 
Partition- sponse (SNA) 
Read or Op Check 
Modified All (non-SNA) 
SF 
Read X‘61’ Read buffer 
Partition- 
Read Buffer 
SF | | 
Read X‘88’ Query replies 
Partition- 
Query SF | 
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Inbound 3270 Data Stream for Partition 0 


Each inbound 3270 data stream for partition 0 is 
preceded by an AID code that identifies the 
cause of this inbound data stream. The preced- 
ing chart lists each cause, the AID associated 
with that cause, and the resulting type of in- 
bound operation. The types of inbound opera- 
tions are: 


@ Short read 

@ Read modified 

@® Read modified all 
@® Read buffer 


Short Read Format: Table G-16 shows that 
the short-read operation results in an inbound 
data stream consisting of only the AID byte. 


Table G-16. Short Read Format 


Attention identifier byte: 
Clear key 
PA1 key 

PA2 key 

PA3 key 
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Read Modified and Read Modified All For- 
mat: The read-modified operation and the read- 
modified-all (SNA only) operation can take place 
in a field, an extended field, or a character reply 
mode. Table G-17 shows a general format for all 
three reply modes. 


Table G-17. Read Modified and Read Modified All Format 


| Byte 


_— 
Content Meaning 


0 AID Attention identifier byte. 


12 CCP Hexadecimal address of the cursor 
(current cursor position). 
— = 
3 X‘11’ SBA order code. 
4,5 x’ Hexadecimal address of the first 


character in the modified field 
(attribute address +1). 


<a +— 
6-n Data Data from the addressed field 
(including graphic escape/APL 
character pairs where appropriate) 
but with null characters suppressed. 
(See Notes 1 and 2. 


l= —] 
The pattern of bytes 3 through n is specified for all other 
modified (MDT bit set to 1) fields. 


Notes: 


le, In character reply mode, the string of data characters 
can also include Set Attribute orders to indicate 
changes in the character attribute value. 


D3 For the read-modified operation, with an AID of 
X‘7E’ (indicating cursor selection of a space or null 
designator character), only the addresses of modified 
fields are transmitted. 


3: If none of the fields has been modified, the inbound 
data stream consists of bytes 0 through 2 only. 


4, If the partition buffer is unformatted, the data 
stream consists of bytes 0 through 2 and bytes 6 
through n (all data in the partition buffer, with nulls 
suppressed). 


Read Buffer Format: The read-buffer opera- 
tion can take place in field, extended field, or 
character reply mode. The read-buffer operation 
transmits the contents of all buffer locations in 
the presentation space, starting at the current 
cursor position. 


Read Buffer Format in Field Reply Mode: 
Table G-18 shows the read buffer format in field 
reply mode. 


Table G-18. Read Buffer Format in Field Reply Mode 


Content Meaning 
‘0 | AID Attention identifier byte. 
bee CCP Hexadecimal address of the cursor 
(current cursor position). 
3-n Data Data characters (including null char- 


acters, but excluding Set Attributed 
orders), starting at the currentd 
cursor position to the start of the 
next field. (See Note.) 


Start Field order code. 


Field-attribute character. 


All data characters to the start of 
the next field. 


The pattern of bytes n+ 1 through m is repeated for all 
other fields being transmitted. 


Note: Set Attribute orders are defined in JBM 3270 Infor- 
mation Display System 8274 Control Unit Description and 
Programmer’s Guide, GA23-0061. 
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Read Buffer Format in Extended Field and 


Character Mode: Table G-19 lists the read 
buffer format in extended field and character 
mode. 


Table G-19. Read Buffer Format in Extended Fieid and 
Character Mode 


Byte 
Eales 


Content 


Meaning 


0 


AID 


Attention identifier byte. 


132 


Hexadecimal address of the cursor 
(current cursor position). 


Data characters (including null char- 
acters), starting at the current cursor 
position to the start of the next field. 


Start Field Extended order code. 


Attribute count (X‘00’ through 
X‘04’). The number of attribute 
specifications (byte pairs) that 
follow. 


Byte pairs are transmitted only for 
those extended field attributes with 
specified (non-default) values. 


Field-attribute type. 

Field-attribute value. 
Extended-field-attribute type. 
Extended-field-attribute value: 
includes highlighting, color, and PS. 
(See ‘‘Attributes.’’) 


Data 


rr 


All data characters to the start of 
the next field. 


The pattern of bytes n+ 1 through m is repeated for all 
other fields being transmitted. 


peace | 


Notes: 


ie Set Attribute orders are defined in JBM 3270 Infor- 
mation Display System 8274 Control Unit Description 
and Programmer’s Guide, GA23-0061. 


2 When in character mode, each string of DATA char- 
acters can include Set Attribute orders to indicate 
changes in the character attribute value. The format 
for these Set Attribute orders is the same as for out- 
bound Set Attribute orders. In extended-field mode, 
no Set Attribute orders are included. 


Inbound Structured Fields 


The inbound structured field AID code (X‘88’) 
precedes and identifies the following inbound 
structured fields for transmission to the host 
program. 


ID Code 
Inbound Structured Field (EBCDIC - Hex) 


Inbound 3270DS (partitions 80 
01-0F) 
(Short read) 
(Read modified) 
(Read modified all) 
(Read buffer) 


Query reply 81 
Usable area 81 
Character sets 85 
Color 86 
Highlight 87 
Reply modes 88 
Implicit partition A6 
DDM 95 


Technical Notes G-33 


Query Reply Structured Field 


The logical terminal to which the read partition 
query function was addressed responds with the 
transmission of a series of structured fields indi- 
cating the field and character attributes, the 
screen or page size characteristics, the symbol 
sets, and the reply modes available on the logi- 
cal terminal. Since each structured field contains 
its own unique identification, the order in which 
the fields are transmitted is not important. The 
query reply structured fields and their associ- 
ated reply codes are as follows: 


Reply Code 

Query Reply Structured Field (EBCDIC - Hex) 
Query reply 81 

Usable area 81 

Character sets 85 

Color 86 

Highlight 87 

Reply modes 88 

Implicit partition A6 

DDM 95 


Usable Area Query Structured Field For- 
mat: The usable area query reply structured 
field indicates to the host program the dimen- 
sions of the logical screen for the logical termi- 
nal. Table G-20 describes the content and 
meaning of the usable area query reply struc- 
tured field. 
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Table G-20. Usable Area Query Reply Structured Field 


Format 
L Byte | Content Meaning | 
0, 1 L Length of structured field in bytes, if: 
X‘0017’ Partitions not supported (0 
partitions defined) 
E x‘81’ ID code of query reply 


X‘81’ 


ID code of usable area reply 
ae A et 


16-bit addressing allowed 


Variable-character cells not sup- 
ported (omit bytes 23-26) per logical- 
terminal definition table 


Width of usable screen for logical 
screen 


[ ae 

8,9 LSH Height of usable screen for logical 

screen 

i — | 
| 10 X‘O1’ Units of measure (millimeters) 

11-14 | Xr Horizontal pitch 
be +— — 
L 5-18 | Yr Vertical pitch 

=e 
19 HS 09 Horizontal character cell size 


VS OE 


Vertical character cell size 


BUFFSZ 


Character buffer size 
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Character Sets Query Reply Structured 
Field Format: The character sets query reply 
structured field is transmitted to inform the 
host program what character sets are defined for 
the logical terminal. Table G-21 describes the 
content and meaning of the character sets query 
reply structured field. 


Table G-21. Character Sets Query Reply Structured Field 


Format 
= - aes = 
Byte | Bit | Content | Meaning 
4 oa a — 

0,1 - L Length of structured field in 
bytes (13 + lengths of 
descriptors) 

2 - X81’ ID code of query reply 

— 

3 - X‘85’ hp code of character sets reply 

ae zi 

4 - Flags Based on logical-terminal defini- 
tion table (EK AB/PS) definition: 

0 0 Graphic escape (EAB) not 
supported 

1 0 Reserved 

2 Oor1 Load PS (EAB and PS) sup- 
ported (0 =no; 1 = yes) 

3 0 or 1 Load PS extension (KAB and 
PS) supported (0 =no; 1 = yes) 

4 0 One size of character cell 
supported 

5-7 | 000 Reserved 


Table G-21. Character Sets Query Reply Structured Field 
Format (continued) 


Byte | Bit | Content | Meaning 
, 

5 ~ X‘00 Reserved 
6 - X‘09’ Default-character cell width 
Re Zak 

7 - X‘OE’ Default-character cell depth 
| 8-11 - X‘6000 | Supported Load PS format 

000’ types; bit-encoded (if bit i = 1, 


then type is supported) 


Length of each descriptor 
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Character Set Descriptors: The following 
table describes the length of each descriptor. 


Table G-22. Character Sets Descriptors 


Byte | Bit Content | Meaning 
i SET Device-specific character set ID 
(RWS or ROS number) 
eee 
2 ~[Fiacs | 
0 LOAD Loadable: 
B‘0’ Nonloadable character set 
B‘1’ Loadable character set 
1 TRIPLE | Triple plane: 
B‘0’ Single-plane character set 
B‘1’ Triple-plane character set 
2 RES Reserved-must be zero 
3 CB Compare bit: 
B‘0’ LCID compare 
B‘1’ No LCID compare 
4-7 | RES Reserved 
ee 
3 Fl LCID Local character set ID | 
—— 


Reply Modes Query Reply Structured Field 
Format: The reply modes query reply struc- 
tured field is transmitted, if EAB is defined, to 
inform the host program which reply modes are 
supported by the logical terminal. Table G-23 
lists the content and meaning for bytes 0-6 of 
the structured field. 


Table G-23. Reply Modes Query Reply Structured Field 


Format 

| Byte [eentent Meaning 
a 1 X‘0007’ Length of structured field in bytes 
fe | X‘81’ ID code of query reply | 
Es | X88’ ID code of reply modes reply 
| 4 X‘00’ Field reply mode supported 
ee X‘01’ Extended-field reply mode supported 

6 X‘02’ Character reply mode supported ij 
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DDM Query Reply Structured Field For- 
mat: Table G-24 lists the content and meaning 
for bytes 0-6 of the structured field. 


Table G-24. DDM Query Reply Structured Field Format 


— 


Byte Content Meaning 

Is ie al 
0, 1 L Length of structured field in bytes | 

[ | ij 
2 81 ID code of query reply 

L a =] 
3 95 ID code of DDM reply 

- a 7 | 
4 ‘00’ File not available 

| | zl 
5 00 Reserved 

L + —} 
6,7 0800 Max DDM bytes per transmission 

allowed inbound 


tee . . 
8,9 0800 Max DDM bytes per transmission 
allowed outbound 
1 = a 


10 01 Number of subsets supported 


11 01 DDM subset identifier 
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Color Query Reply Structured Field For- 

mat: The color query reply structured field indi- 
cates to the host the color that will be displayed 
for each of the color attribute values. Table G-25 


describes the content and meaning for this struc- 
tured field. 


Table G-25. Color Query Reply Structured Field Foramt 


Byte | Content Meaning 
[0,1 | xo026' Length of this structured field in bytes 
2 x ol ID code of query reply 
3 X‘86’ ID code of color reply 
| 4 X‘00’ Reserved 
5 X‘08’ Length of attribute list (number of color 
attribute pairs) 
X‘00’ Default color attribute 


| 


les 


X‘F4’ 


X‘FIFIF2F2 
F3F3F4F4 
F5F5F6F6 
FTF7’ 


‘F1F4F2F4 | For mono display, each color maps to 
F3F4F4F4 | green. 
F5F4F6F4 


F7F4’ 


Green is the device default color 


For color display, each color maps to itself. 


Notes: 


1. Bytes 6 and 7 are always used to indicate the IBM 3270 Per- 
sonal Computer default color. 


2: If extended attributes is not enabled by the logical-terminal defi- 
nition table, the color query reply is not returned. 
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Highlight Query Reply Structured Field For- 
mat: The highlight query reply is transmitted 
inbound as a structured field with the format 
shown in Table G-26. 


Table G-26. Highlight Query Reply Structured Field 


Format 
Byte | Content || Meaning _| 
0,1 X‘000D’ Length of this structured field in 
bytes 
zai tes 

2 X‘81’ ID code of query reply 
[3 | x87 ID code of highlight reply 

4 | X‘04’ Number of byte pairs that follow 

5 | X‘00’ i Acceptable attribute value 

6 X‘FO’ | Default-highlight action code 
[7 X‘F 1’ li Nbeepbed attribute value 

8 XFL Blink action code 

9 xX’ FQ’ Accepted attribute value 

10 X‘F2’ Reverse action code 

11 X‘F4’ Accepted attribute value | 
42 Ty xere Underscore action code 
Notes: 


a Bytes 5, 7, 9, and 11 of a highlight query reply indi- 
cate to a host the attribute values that the IBM 3270 
Personal Computer: 


a. Can accept in an outbound extended-highlight 
attribute byte. 

b. Will preserve and will return to the host in a 
subsequent inbound operation (unless changed 
by the operator). 


2. Bytes 6, 8, 10, and 12 indicate to a host what action 
the IBM 3270 Personal Computer performs for each 
of those attribute values. 


3. If extended attributes is not enabled by the logical- 


terminal definition table, the highlight query reply is 
not returned. 
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Implicit Partition Query Reply Structured 
Field Format: The implicit partition query re- 
ply structured field is always returned by the 
IBM 3270 Personal Computer logical terminal. 
It informs the host of the default and alternate 
sizes for the target logical terminal’s implicit 
partition. It may also return the cell size in ef- 
fect for the default and alternate screen sizes. 
Table G-27 shows this structured field format. 


Table G-27. Implicit Partition Query Reply Structured 
Field Format 


Content Meaning 


Length of structured field (in bytes) i 
— 
ID code of query reply 


ID code of implicit partition reply | 


Reserved 


Implicit Partition Default and Alternate 
Screen Size: For SNA, the default and alter- 
nate screen sizes returned in this reply are those 
established at BIND to this logical terminal. 


For non-SNA, the default and alternate screen 
sizes returned in this reply are those in effect 
for this logical terminal at the time the reply is 
generated. 


Character Cell Dimensions: The dimensions of 
the character cells in effect for the default and al- 
ternate screen sizes are returned only when the 
character cell size for either the default or the al- 
ternate implicit partition is different from the 
cell size specified in the usable area query reply. 
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Self-Defining Parameters: The following im- 
plicit partition size parameter, shown in Table 
G-28, is always returned as part of the implicit 
partition query reply. 


Table G-28. Self-Defining Parameters 


. 

Byte | Content | Meaning 

te et 

ie L Length of parameter (in bytes) 

_| 
1 X‘O1’ Parameter of screen size dimensions 
i = 
2 X‘00’ Reserved 
fe = 
3, 4 WD Width of default screen size in cells 
— — + 
5,6 HD Height of default screen size in cells 
7,8 WA | Width of alternate screen size in cells | 
| 9, 10 | HA Height of alternate screen size in cells 

Notes: 

1. Bytes 3 and 4: For SNA, the width of the default 
implicit partition is the value established at logical- 
terminal BIND time. For non-SNA, the width of the 
default implicit partition is 80. 

2. Bytes 5 and 6: For SNA, the height of the default 
implicit partition is the value established at logical- 
terminal BIND time. For non-SNA, the height of the 
default implicit partition is 24. 

3. Bytes 7 through 10: For SNA, the width and the 


height of the alternate implicit partition are the 
values established at logical-terminal BIND time. For 
non-SNA, the width and the height of the alternate 
implicit partition are the values defined in the logical- 
terminal definition table. 


Transmission of Buffer Addresses 
The following text describes: 


1. The relationship between a given row/ 
column position in a partition’s presentation 
space and its address in the partition’s 
buffer storage. 


2. How a buffer storage address is transmitted 
to and from the IBM 3270 Personal Com- 
puter in each of the two address modes. 


Buffer Addresses 


The relationship between any given row/column 
position in a partition and its address in the par- 
tition’s buffer storage is expressed thus: 


Buffer address = W x (R-1) + (C-1) 
Where: 


W is the partition width (number of columns) 

R is the row number (counting from 1) of the 
position being addressed 

C is the column number (counting from 1) of 
the position being addressed 


Note: For column 1, row 1, the buffer address 
is 0. 


Example of Buffer Address Calculation: 
Given a partition width (W) of 50 columns, what 
is the buffer address of the character location in 
column 46 and row 21? 


Buffer Address = (50 x 20) + 45 = 1045 
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Transmission of a Buffer Garéae 


A buffer address is always transmitted in a 
2-byte field. 


The way in which a buffer address is transmitted 
(for example, in the 2 bytes after the X‘11’ byte 
in a Set Buffer Address order, or in the 2 bytes 
that specify the current cursor position in an 
inbound read operation) depends on the address 
mode for the partition. 


A partition has one of two address modes: 
@® 16-bit address mode 
@ 12/14-bit address mode. 


Transmission of Buffer Address in 16-Bit 
Address Mode 


In 16-bit address mode, buffer addresses are 
transmitted outbound and inbound as 16-bit 
binary numbers. 


Transmission of Buffer Address in 12/14-Bit 
Address Mode 
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In 12/14-bit address mode, bits 0 and 1 of the 
first address byte have the following bit 
significance: 


00 - 14-bit binary address follows 
01 - 12-bit coded address follows 
11 - 12-bit coded address follows 


(In an outbound transmission, if bits 0 and 1 of 
the first byte are set to B‘10’, a sense code of 
X‘1005’ is returned.) 


For outbound transmissions, IBM 3270 Personal 
Computer uses these first 2 bits to determine 
whether the address in the transmission is 12-bit 
or 14-bit. For inbound transmissions, the size of 


the partition determines whether the address 
transmission is 12-bit or 14-bit. If the partition 
size is greater than 4096 bytes (excluding charac- 
ter attributes if an EAB device), 14-bit addresses 
are used. Otherwise, 12-bit addresses are used. 


14-Bit Addresses: 14-bit buffer addresses are 
transmitted outbound and inbound with bits 0 
and 1 of the first byte equal to B’00’, followed by 
the buffer address expressed as a 14-bit binary 
number. 


12-Bit Addresses: 12-bit buffer addresses are 
transmitted outbound and inbound with the fol- 
lowing format: 


BBaa aaaa |BBaa aaaa 


First Byte Second Byte 


Where: 


a represents the binary value of the address 
(12 bits), and BB is B‘01’ or B‘11’ (see text 
below). 


The 12-bit address EBCDIC values for decimal 
addresses 0 through 10879 are derived as 
follows: 


1. The 12-bit binary representation of the deci- 
mal address is split into two 6-bit groups. 


2. The more significant 6-bit group occupies 
bits 2 through 7 of the first byte. 


3. The less significant 6-bit group occupies bits 
2 through 7 of the second byte. 


4. According to the value of bits 2 through 7 in 
each byte, bits 0 and 1 of each byte are set 
to obtain the hexadecimal representations, 
as defined in Table G-30. The resulting 
EBCDIC value represents a graphic charac- 
ter in the range X‘40’ through X‘F9’. 
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Table G-29. Hexadecimal Representations 


Bits a7 | EB* Bits 2-7 Bits 2-7 

00 0000 | 40 es 

00 0001 | C1 01 0001} D1 11 

00 0010 | C2 01 0010 | D2 E2 11 0010] F2 
00 0011 | C3 01 0011! D3 E3 11 0011] F3 
00 0100 | C4 01 0100; D4 E4 11 0100; F4 
00 0101) C5 Ol 0101} D5 E5 11 0101] F5 
00 0110] C6 01 0110] D6 E6 11 0110] F6 
00 O111 | C7 01 0111) D7 E7 11 0111] F7 
00 1000 | C8 01 1000] D8 E8 11 1000 | F8 
00 1001 | C9 01 1001] D9 E9 11 1001] F9 
00 1010] 4A O01 1010] 5A 6A 11 1010] 7A 
00 1011] 4B 01 1011] 5B 6B 11 1011] 7B 
00 1100] 4C 01 1100] 5C 6C 11 1100] 7C 
00 1101 | 4D 01 1101] 5D 6D 11 1101] 7D 
00 1110] 4E O01 1110] 5E 6E 11 1110] 7E 
00 1111; 4F O1 1111] 5F 6F 11 1111] 7F 

soos] 


Note: The 12-bit address EBCDIC values for decimal ad- 
dresses 0 through 3568 are listed in the [BM 8270 Information 
Display System Buffer Address Codes, GA23-0057. 


* EB = EBCDIC 
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Mandatory Card Slot 
Assignments 


The adapters in Table G-30 must be installed in 
the card slots listed. 


Table G-30. Mandatory Card Slot Assignments 


Card Slot 


3274 Communication 
Adapter 


oo es 
[inhouse Ader |X [|X 
rr ina Adee | [x 
sa) | Keyboard Adapter |X [|X 


Note: Optional adapter cards may be put into any 
open card slot that does not conflict with the above 
mandatory slot assignments. Other optional adapter 
cards are: 


Memory Expansion Adapter 

Printer Adapter Asynchronous Adapter 
All Points Addressable (APA) Adapter 
Programmed Symbols (PS) Adapter 
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Changes or Limitations to the 
Personal Computer Session 


Following are the changes or limitations to the 
personal computer session in application mode 
when operating under the control program. Note 
that if you are running a personal computer ap- 
plication program through the IBM 3270 Per- 
sonal Computer Control Program, there may be 
unpredictable results in some cases. 


Personal Computer Physical Cursor 


Auto-windowing in the personal computer ses- 
sion occurs only in response to the movement of 
the personal computer session physical cursor. 
Some IBM Personal Computer application pro- 
grams do not use the physical cursor, but use 
other types of cursors. These other types of 
cursors will not support the auto-windowing 
function. If you want auto-windowing to occur, 
you must convert such applications to use the 
physical cursor. 


If an application has inhibited the default cursor 
but you chose an alternate cursor, the alternate 
cursor will be the cursor you see. 


Personal Computer Print Spooling 
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The DOS print spooler will not operate with the 
IBM 3270 Personal Computer and should never 
be activated. If you use the print spooler, it may, 
and in most instances will, cause the 3274 com- 
munication session to terminate. See “3274 Com- 
munication Session Termination’’ below. 


3274 Communication Session 
Termination 


The personal computer application actions that 
may, and in most instances will, cause the 3274 
communication session to terminate are: 


@ Use of the disable/enable functions for an 
extended period of time. 


@® Failure to issue an end-of-interrupt on a 
hardware interrupt level for an extended 
period of time. 


@® Masking of selected interrupt levels for an 
extended period of time. 


@ Failure to issue an IRET for an extended 
period of time. 


IBM 3270 Personal Computer Failure 


The IBM 3270 Personal Computer will, in most 
cases, fail in an unpredictable manner if you: 


@ Access memory above the pointer in BIOS 
memory, except to refer to the IBM Per- 
sonal Computer display refresh buffer. 


@ Use interrupt vectors X‘50’ through X‘57’ 
or reprogram the 8259. 


Color Limitations 


The IBM 3270 Personal Computer supports 
eight colors for personal computer applications. 
If you use the Personal Computer color printer 
to print a Personal Computer color graphics 
screen in medium resolution graphics, the 3270 
Personal Computer Control Program uses the 
blue color to determine which color palette is 
displayed. In palette 0 there is no blue and the 
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colors printed are black, blue, and pink. If you 
change the background color to green, blue, tur- 
quoise, or white while using palette 0, the blue 
color gun is turned on and the colors for palette 
1 are used. The color palette select register is 
Write only and cannot be checked. 


Notes on All Points Addressable 
Graphics 
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If you use the IBM Personal Computer all points 
addressable (APA) graphics applications on the 
IBM 3270 Personal Computer, please note that 
your graphics images may appear differently. 
For example, you may have ovals in place of 
circles. For images to appear normally on the 
IBM 3270 Personal Computer, you must set the 
aspect ratio parameters in the application pro- 
gram. For example, in BASIC, add the aspect 
ratio parameter to the CIRCLE command to get 
circles instead of ovals on the display screen. 
Below is a table describing both IBM Personal 
Computer and 3270 Personal Computer ratios. 


3270 PC 


High 2:54 
Resolution (approx. 2:3) 


Medium 
Resolution 


35:27 
(approx. 5:4) 


Note: The current aspect ration parameters are also availa- 
ble dynamically. A video interrupt (INT ‘10’) must be made 
to BIOS. Register AH must contain ‘30’. This function 
causes an address to be returned in CX (segment) and DX 
(offset) which points to the aspect in two hexadecimal 
bytes: ‘23’ and ‘36’ for high resolution, or ‘23’ and ‘1B’ for 
medium resolution. The BIOS character generator cannot 
be used while in full screen mode. 


Using the Full Screen All Points 
Addressable Mode 


When emulating the IBM Personal Computer 
Color Graphics Adapter, note that approxi- 
mately one half of the display screen is used 
(640 x 200 PELs). In addition, the All Points 
Addressable adapter is capable of displaying 720 
x 350 PELs. To set this full screen mode, a video 
interrupt (INT ‘10’) must be made to BIOS. For 
high resolution full screen graphics mode (720 x 
350 PELs), Register AH must contain ‘0’ and 
Register AL must contain ‘30’. For medium 
resolution full screen graphics mode (360 x 350 
PELs), Register AH must contain ‘0’ and 
Register AL must contain ‘31’. 


For either full screen graphics mode, the storage 
addressing scheme changes from the standard 
IBM Personal Computer odd/even scans to a 
simpler, contiguous map of 32K starting at 
‘B8000’. For example, the first byte of the sec- 
ond scan line is addressed as 90 (‘5A’). The IBM 
Personal Computer screens use the standard 
IBM Personal Computer map. 


Personal Computer Display Blanking 


Personal computer applications control their 
display images by writing to a series of input/ 
output (I/O) registers, as described in the [BM 
Personal Computer Technical Reference. Even 
those applications that use DOS or BIOS 
services directly ultimately do this, since those 
programs write to I/O registers to complete their 
display service requests. 


The IBM 3270 Personal Computer emulates each 
I/O register function within the personel com- 
puter window. Among the functions provided is 
the ability to disable or blank the display and to 
reenable it, using port 3B8 for a monochrome 
display or port 3D8 for a color display. As the 
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IBM 3270 Personal Computer emulates this 
function, the personal computer window will 
blank when the personal computer display is dis- 
abled. Personal computer data reappears when it 
is reenabled. 


This disable function is used extensively by 
some personal computer applications. If an appli- 
cation is writing a large quantity of data to the 
display, it disables the display during the 
writing process. This eliminates the ‘‘confetti”’ 
on the display screen. However, disabling the 
display also causes the display screen to flash 
during screen updates. The IBM 3270 Personal 
Computer Control Program has eliminated the 
flashing problem by ignoring this disable re- 
quest. As a result, personal computer applica- 
tions that previously flashed during updates do 
not flash any longer. 


There may be some situations when you do not 
want the disable request ignored. The applica- 
tion may have disabled the display to hide some 
activity. In this case, you may want to override 
automatic deactivation of the disable screen 
function. To do this, enter a personal computer 
session in application mode and press Sys Rq. 
This causes the IBM 3270 Personal Computer to 
respond to disable requests by blanking the per- 
sonal computer window. Pressing this key 
sequence again causes disable requests to be 
ignored again. 


Note: The following appears in the personal 
computer operator information area and indi- 
cates the disable active state: 


xO 
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Using Programmed Symbols H-1 


Notes: 


Introduction 


This appendix is for anyone who wants to use 
Programmed Symbol (PS) features on the IBM 
3270 Personal Computer. To use the PS feature, 
you must have programmed symbol host sup- 
port, the Programmed Symbol adapter card 
installed in the system unit and your 3270 Per- 
sonal Computer must be customized for 
programmed symbols. 


A programmed symbol is a special character or 
graphic component that is loaded by a host ap- 
plication program into a symbol set in the IBM 
3270 Personal Computer. Enough storage space 
is provided to hold the patterns for 192 symbols 
in each symbol set; the IBM 3270 Personal Com- 
puter can hold up to six programmed symbol 
sets. The symbol set indicators are: 


@ PSA 
@ PSB 
@ PSC 
@® PSD 
@ PSE 
@ PSF 


Press Alt + PF1 through PF6 to select one of 
these sets. The operator information area dis- 
plays the symbol set indicator you are using. 
(Refer to IBM 8270 Information Display System 
3278 Display Station Operator’s Guide, GA27- 
2890, for additional information.) 
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To define a symbol, the host application pro- 
gram turns on only those bits in a location that 
relate to the active dots needed to display the 
symbol. 


Some examples of programmed symbol use are: 
@ Characters from foreign alphabets 


Mathematical signs and symbols 


® Scientific signs and symbols 
@ Special type fonts, for example, italics 
@® Sets of graphic elements used to build bar 


graphs, bar charts, and other graphic repre- 
sentations of data. 


The characters you see on your display screen 
are made up of a pattern of active dots. Each 
character position on the screen is addressed by 
the display as a matrix of dots, as shown below. 


* 
* 
* 
* 
* 
x 
* 
* 
* 
* 
* 
% 
#& 
* 


** ok &k KF £ KK kK KR K K K OK 
Ke Ok OK £ KK OK RK KK KK 
* ok ko kK KF KF KK KOK KK 
Ok KK FR K KOK KOK KOK K 
* oe kK OK KK OK K RK EK KK OF 
x £ kK KF KK KK RK KK OK 
* kK K RK Oe KK OK RK KS KK 
KK Re kK K KOR KK KOK OK 


<e) 


& 


Unlike the 3278 and 3279 display stations, the 
IBM 3270 Personal Computer has just one char- 
acter size, a width of 9 and a height of 14. 
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Characters of the base character set are defined 
within the display station as a pattern of active 
dots in this matrix, as shown below. 


Base Character 


The active dots form the character seen on the 
display screen. The number of dots in the matrix 
and the size of the matrix vary between display 
stations. 


Before You Begin 


Before you can use the Programmed Symbol 
feature, 


1. Make sure your work station has the Pro- 
grammed Symbol adapter card installed in 
the system unit. 


2. The customized system diskette you are 
using must have one host session custom- 
ized for programmed symbols. 


3. Logon to a host session that has applica- 
tions that send programmed symbols to the 
display, such as graphic applications, and 
start the application. 


Note that you can use your IBM 3270 Personal 
Computer as it is intended while working with 
Programmed Symbol applications. For example, 
you can size your windows, move them, hide 
them, corner them, and so on. 
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The Symbol Sets 


Programmed symbol sets are either single-plane 
or triple-plane. Single-plane symbol sets have no 
inherent color characteristic and are available for 
monochrome, plasma panel and color displays. 
The advantage of a triple-plane symbol set is 
that it allows more than one color to be used in a 
single character position, for example, a red 
character position overlaying a green character 
position would appear yellow on the display 
screen. Triple-plane symbol sets are, therefore, 
not available on monochrome displays. Regard- 
less of the type of display you have, the same 
adapter card is installed in the system unit of 
the IBM 3270 Personal Computer. 


Note: If you have a color display and are using 
the Programmed Symbol feature. triple-plane 
symbols, the cursor will always appear white, for 
either the default ‘“‘bar’’ or the alternate cursor 
(block). If you have a monochrome display and 
are using programmed symbols, the cursor will 
appear in reverse video for either the default or 
alternate cursor. 


In certain applications, you may need to display 
in more than one color within a single character 
position. A typical example of a symbol that re- 
quires a triple-plane symbol set occurs where the 
application program displays a graph with lines 
in different colors. 


This graph shows three separate lines: last 
year’s sales, this year’s forcast sales, and this 
year’s actual sales. Each line is to be displayed 
in a different color. At the point where two or 
more lines cross, each line needs to hold its color 
in the same character position as another line. 
Be aware of color mixing that may occur at the 
point common to several lines. The system 
works as follows: 


Primary Colors 


As stated above, some of the symbol sets availa- 
ble in the programmed symbols features are 
triple-plane symbol sets. Such sets contain three 
times the normal amount of storage for each 
defined character, arranged in three planes each 
representing one of the three primary colors red, 
blue, and green. By defining only a portion of the 
total symbol in each color plane, you can obtain 
a whole symbol in more than one color. 
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Take, for example, the instance where two hori- 
zontal lines, one blue and one yellow, are cut by 
a red vertical line. The active dots at the char- 
acter position may appear as follows: 


Red Plane Blue Plane Green Plane 


What You See 


SSS ae ie 
=e: Se ee ee 
bbbbrbbbb 
SSS Fee SS 
—_ ma FF ees (oe 
SSS SS 
eS SS 3 OSS 
V¥VVEVVVY¥ 
Sasa 2 SSS a 
a) Sar Se a a es tas 


— mer meee: F —— 


Legend 

active red bit 
active blue bit 
active yellow bit 
active green bit 
blank 


Note: The symbol extends to the edges of the 
character position, thus allowing the lines to con- 
tinue without interruption into the adjacent 
character positions. 


Take, for example, the instance where two hori- 
zontal lines, one blue and one yellow, are cut by 
a red vertical line. The active dots at the char- 
acter position may appear as follows: 


Red Plane Blue Plane Green Plane 


end 

active red bit 
active blue bit 
active yellow bit 
active green bit 
blank 


& 


L 
r 
b 
y 
g 


Note: The symbol extends to the edges of the 
character position, thus allowing the lines to con- 
tinue without interruption into the adjacent 
character positions. 
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Secondary Colors 


Secondary colors are obtained by mixing red, 
blue, and green. The secondary colors are pink, 
yellow, turquoise, and white. If a bit is active in 
more than one plane, the active primary colors 
combine to produce secondary colors, as shown 
below: 


Primary Colors Secondary Colors 


Red Blue Green | What you See 


No No No No display 
No No Yes Green 

No Yes No Blue 

No Yes Yes Turquoise 
Yes No No Red 

Yes No Yes Yellow 
Yes Yes No Pink 

Yes Yes Yes White 


Character Attributes and Triple-Plane 
Symbols 


Character attributes, such as reverse video, 
underscoring, and blinking, will have no effect 
when you are using triple-plane symbols. Your 
data will appear as it has been loaded into the 
triple-plane symbol font. 
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Additional Information 


For additional information on programmed 
symbols, refer to: 


@ IBM 8270 Information Display System, 3274 
Control Unit Description and Programmer’s 
Guide, GA23-0061. 


@® IBM 3270 Information Display System 8278 
Display Station and Programmer’s Guide, 
GA27-2890. 


® IBM 3270 Information Display System: 
Color and Programmed Symbols, 
GA383-3056. 


Glossary 


A 


active window. The window outlined with a 
double border and containing the cursor, indica- 
ting the session to which your keyboard is logi- 
cally ‘‘attached.’’ (See selected window.) 


adapter card. A supplementary hardware com- 
ponent added to the system unit of your work 
station that expands basic function. 


add window. The work station function that al- 
lows you to place a window within a screen pro- 
file. 


all points addressable graphics. A personel com- 
puter programming capability enabled by the ad- 
dition of a graphics adapter card that allows you 
to draw complex pictures and provides more ver- 
satility than special line and block characters 
usually available. 


Alt key Functions. Keyboard functions printed 
on the front of the keys that are selected when 
the Alternate (Alt) key is pressed in conjunction 
with the desired key. 


American National Standard Code for Informa- 
tion Interchange (ASCII). One of the two stand- 
ard codes used for exchanging information 
among data processing systems and associated 
equipment; the standard code used by the IBM 
Personal Computer and other microcomputers. 
(Contrast with EBCDIC.) 


APA. All points addressable (See all points 
addressable graphics). 


Glossary X-1 


application. The use to which a data processing 
system is put; a program that is written by or 
for a user for performing a particular task, for 
example, a payroll application program. 


application mode. The mode of operation in 
which your work is logically ‘‘attached’’ to one of 
the following: a host computer session, the per- 
sonal computer session, or a notepad session. 
(Compare with work station control mode.) 


application window area. The topmost portion 
of your screen; the area that contains your win- 
dows. It is composed of ten screen profiles, 
numbered 0 through 9. 


ASCII. American National Standard Code 
for Information Interchange. (See American 
National Standard Code for Information 
Interchange.) 


auto-windowing. A characteristic of application 
mode in which the cursor scrolls the information 
within the presentation space behind the active 
window. The function is automatic; when the 
cursor reaches the edge of a window, the infor- 
mation behind the window moves automatically 
so that the cursor is always visible. (Contrast 
with browse.) 


autokeying. A function that starts the continu- 
ous printout of recorded text; a control program 
capability that lets you record frequently used 
groups of keystrokes and plays them back at 
designated locations on the screen. 


B 


back up (verb). When dealing with diskettes, to 
duplicate data from a fixed disk drive or diskette 
to another diskette to ensure availability of data 
in the event of loss of or damage to the original; 
do not confuse this term with the DOS fixed disk 
command (see IBM Personal Computer Disk 
Operating System manual). 


background color. The color of the window 
‘“‘writing surface.”’ (Contrast with foreground 
color.) 


base color. The four colors white, red, blue, and 
green assigned according to protection and in- 
tensity attributes of the 3270 field attribute 
byte. 


BASIC. Beginner’s All-Purpose Symbolic In- 
struction Code. (See Beginner’s All-Purpose In- 
struction Code.) 


Beginner’s All-Purpose Symbolic Instruction 
Code (BASIC). A high-level, widely used com- 
puter programming language. 


break. A personal computer function that halts 
whatever action is in progress, such as stopping 
a program in the middle of execution. 


browse. The work station function that allows 
you to move the data contained in the presenta- 
tion space vertically and horizontally within an 
application window. 


C 


change. A work station function, available both 
inside and outside work station control mode, 
that allows you to cycle through defined screen 
profiles in numeric order with the ChgSc key or 
to call up a specific screen profile by its numeri- 
cal name by pressing the WS Ctrl key plus the 
number of the desired screen profile. (Compare 
with jump.) 


color. One of the Level 3 functions (a subset of 
Set Up) allowing you to set and change the colors 
(both foreground and background) of individual 
sessions to one of eight colors; to set some host 
sessions to the base four-color 3270 data stream 
defaults; and to set screen background color 
when you are using a color display. 


Glossary X-3 


combination keys. Keys that must be used in 
conjunction with another key or keys to produce 
a desired function; these include the personal 
computer keys Control, Shift, and Alternate, and 
the host computer keys Shift and Alternate. 


control functions. Keyboard functions in per- 
sonal computer mode requiring the use of the 
Control (Ctrl) key in conjunction with another 
key. 


control program function. The set of functions 
in the IBM 3270 Personal Computer allowing 
you to create windows, change their size and po- 
sition, and hide and enlarge them; use autokey- 
ing and copying; save and restore autokey 
recordings, notepad contents, and screen pro- 
files; and transfer files between hose computer 
and personal computer sessions. 


control unit terminal (CUT). An operational 
mode that allows one logical terminal session. 
(Contrast with distributed function terminal 
(DFT).) 


copy. The work station function that allows you 
to mark source lines in one text mode window 
and move them to a target location in within the 
same window or from one window to another on 
the same screen profile or a different screen pro- 
file. You can copy from any window into any 
window except a personal computer. 


corner. The work station function that allows 
you to move a window clockwise to each of the 
four corners of the screen. 


cursor. The movable spot of light, on a display 
screen, that indicates where the next character 
will be entered, replaced, or deleted. 


cursor movement keys. The arrow keys that 
move the cursor up, down, left, and right. There 
are two sets of cursor movement keys. The black 
cursor movement keys in the cursor key area of 
the keyboard are used to execute host computer 
functions, work station functions, and personal 
computer functions. The blue cursor movement 
keys in the numeric keypad are for personal com- 
puter applications only. Within the Browse func- 
tion, the cursor movement keys scroll the data 
within the window; within the Size function, they 
move the window borders; within the Copy func- 
tion, they move the cursor to mark source and 
target blocks. When you use a personal com- 
puter application program with your IBM 3270 
Personal Computer and without the control pro- 
gram software, you must use the blue cursor 
movement keys. 


customization. The process by which your con- 
trol program diskette is tailored to your 3274 
controller host computer configuration; accom- 
plished through a set of interactive prompt 
screens. 


customize. With IBM 3270 Personal Computer 
Control Program diskettes, to tailor your control 
program diskette to reflect the 3274 controller 
host computer configuration to which the work 
station is attached and to your needs or those of 
your organization. 


customized system diskette. A control program 
diskette on which the customization procedure 
has been performed. (See customization.) 


CUT. Control unit terminal. (See control unit 
terminal (CUT).) 
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D 


data. All information entered into or used by a 
computer. 


default. A value that is assumed when none has 
been specified. 


defined screen. A screen profile containing one 
or more windows. 


delete window. The work station function that 
allows you to remove a designated window from 
a screen profile. 


Disk Operating System (DOS). A program that 
interacts with the system unit and the disk/ 
diskette drive to control the flow of data. The 
DOS programs control the way your personal 
computer session uses other personal computer 
programs. DOS tells your personal computer ses- 
sion how to use the information you supply to 
the programs and how to return information 
that the programs supply to you. 


diskette. A personal computer storage device 
consisting of a flexible magnetic disk inside a 
protective plastic jacket. 


diskette drive. A device that uses diskettes for 
mass storage and retrieval of data. 


display. An output unit for the visual display of 
data. 


Distributed Function Terminal (DFT). An opera- 
tional mode that allows multiple concurrent 
logical terminal sessions. 


DOS. Disk Operating System. (See Disk Operat- 
ing System.) 


E 


EBCDIC. Extended binary-coded decimal inter- 
change code. (See extended binary-coded decimal 
interchange code.) 


Enlarge. A toggle key that allows you to in- 
crease the dimensions of your windows to full- 
screen size; initiated by the Enlarge key, which 
is valid in both work station control mode and 
application mode. Enlarge does not affect char- 
acter size but instead enlarges the screen area. 


erase. In autokey mode, to remove from autokey 
storage a recording you no longer need. 


Extended Binary-Coded Decimal Interchange 
Code (EBCDIC). A coded character set consist- 
ing of 8-bit coded characters. 


extended color. The seven colors red, blue, 
green, white, yellow, pink and turquoise applied 
to both whole fields and individual characters. 
within fields independently of any other attrib- 
utes of the data. 


F 


file. A collection of data. This data can be pro- 
grams, word processing files, or computational 
information. Files are stored either in the host 
computer or on personal computer diskettes. 
Files are also called data sets. 


file transfer. The work station function that 
allows you to send and receive files between a 
personal computer session and a host computer 
session when the file transfer code is accessible 
through your host computer session. 


file transfer program. A host computer program 
that allows you to use the file transfer function. 
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finish. The key that ends your activity at one 


work station level and moves you up one level; 
for example, Finish in the Size function (Level 3) 
would return you to SetUp (Level 2). 


fixed disk. A type of work station storage used 


_for mass storage and retrieval of data. This stor- 
“age device is housed in the system unit. 


foreground color. The color of characters within 
-a window (Contrast with background color.) 


G 


graphic. A symbol produced by a process such 
as handwriting, printing, or drawing. 


H 


hardware. The physical equipment used in data 
processing, as opposed to programs, procedures, 
and associated documentation. (Contrast with 
software.) 


Help. An aspect of work station control mode 
that overlays the right side of your current 
screen with information about the status of your 
work station control functions and keys. Help is 
a toggle key. Once it is toggled on, Help informa- 
tion changes as you move among the work 
station levels. 


-HELPER. The IBM 3270 Personal Computer 
‘Online Tutorial, consisting of an interactive self- 
teaching diskette and a booklet. 


hide. The work station function that allows you 
to remove a window temporarily from the screen 
-profile in which it appears: it does not delete the 
“window or affect its presence on other screen 
profiles; it merely ‘“‘hides’’ it. (Compare with 
delete window.) 


home. The initial cursor position, located in the 
upper left corner of the presentation space. 


host computer. A central computer that pro- 
vides services such as computation, data base 
access, and special programs or programming 
languages to a number of users. 


I 


initial progam load (IPL). The first process in 
operating your work station, which causes the 
operating system to commence operation. 


IPL. Initial program load. (See initial program 
load.) 


J 


jump. The work station function, available both 
inside and outside work station control mode, 
that allows you to move from window to window 
on a screen profile; initiated with the Jump key 
or by pressing the WS Ctrl key and the letter 
name of the window. 


L 


left control keys. The keyboard area to the left 
of the main keyboard, (the Typewriter Key area) 
containing many of your work station control 
Keys. 


list. The function initiated by pressing PF1 that 
overlays the right side of your screen with an 
ordered set of items. Two kinds of listing are 
possible: List Window and List Autokey. List 
Window, initiated anywhere in work station con- 
trol mode, displays the window assignments and 
screen profiles. List Autokey, initiated from the 
autokey function, displays the names of autokey 
recordings, recording lengths, and remaining 
autokey storage. 
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load (verb). To read a copy of a computer pro- 
gram or data from a diskette into work station 
storage. 


logging on. The procedure by which you are 
linked to a multiple-user host computer system; 
the procedure requires a user identification 
(userid) and a password. 


M 


menu. A list of available operations. You select 
which operation you want from the list. 


menu number. The number associated with a 
unit of information to call that unit to the 
screen. 


message. An ordered series of characters dis- 
played near the bottom of the screen to convey 
important information about the status of the 
work station from the machine to the user. 


message line/user prompt area. The line on your 
screen just above the operator information area 
on which messages and prompts from your work 
station are displayed. 


move. The work station function that allows you 
to move a window either horizontally or verti- 
cally on the screen. 


N 
NMI. Non-Maskable Interrupt. 


Non-Maskable Interrupt. A button on the key- 
board adapter at the back of the system unit 
that allows you to start a dump process when 
the keyboard does not respond to any input. 


normal path. In the HELPER tutorial, looking 
at every panel and working the associated 
exercises; initiated by pressing any MENU 
NUMBER from the main menu. (Contrast with 
quick path.) 


notepad. The application mode session that con- 
tains notes you make to yourself at your work 
station; its keyboard is similar to the host key- 
board; its contents disappear at the end of a 
session unless stored with the Save utility. 


numeric keypad. The rightmost area of your 
keyboard. In application mode, when your per- 
sonal computer session is active, the numeric 
keypad is also a cursor key movement area; 
NumLk toggles between cursor keys and 
numeric pad. In application mode, when a host 
computer session or a notepad session is active, 
this area is a numeric keypad. 


O 


OIA. Operator information area. (See operator 
information area.) 


operator information area (OIA). The bottom- 
most line of your screen where you receive infor- 
mation about the status of your work station 
and your host, notepad, and personal computer 
sessions. 


overlay (verb). To place one set of information 
temporarily over another. 


P 
panel. A screen full of information. 


Pause. In the autokey function, a toggle key 
that places a pause within a recording or that 
causes the playback of a recording to resume 
after a recorded pause. 


personal computer graphics printer. The 
desktop printer attached directly to your IBM 
3270 Personal Computer (Contrast with 3274- 
attached printer.) 
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Play. In the autokey function, the key that 
initiates the playback sequence of an autokey 
recording whose name is entered in the OIA. 


power on. To switch on the system unit and/or 
monitor of your work station in order to begin a 
session. 


presentation space. A concept that represents 
the area that contains the data that goes to your 
display screen during an IBM 3270 host session, 
an IBM Personal Computer session, or a note- 
pad session. 


program function key. A key that passes a sig- 
nal to a program. The program function keys are 
located in the topmost area of your keyboard. 
This area contains host computer PF keys and 
personal computer function F keys. The IBM 
3270 Personal Computer PF keys and the IBM 
Personal Computer F keys are two names for the 
same key. Many of the work station control 
functions are located here; their names are 
printed on a template that fits over this key- 
board area. 


prompt. A request for information that guides 
the user by describing required input or giving 
necessary operational information. 


Programmed Symbols adapter. An adapter card 
that enables a user to define and extend the 
characters, symbols, and signs that can be dis- 
played or printed in text to meet the special 
needs of the user’s host applications. Examples 
include characters from foreign alphabets; math- 
ematical signs and symbols; scientific signs and 
symbols; special type fonts such as italics; and a 
set of graphic elements that can be used 

to build graphs, bar charts, and other graphic 
representations of data. 


Programmed Symbol set. One of six sets of 
characters named PSA-PSF enabled by the addi- 
tion of a programmed symbols adapter card and 
appropriate host computer capability. 


Q 


quick path. In the HELPER tutorial, the main 
menu option that allows long-time IBM 3270 
display users to see a highly condensed version 
of HELPER. The function is toggled on with the 
Q key from the main menu. (Contrast with 
normal path.) 


Quit. The work station control mode functions 
reached by pressing Alt Reset, which halts or 
eliminates whatever work station function is 
executing. 


R 


Receive command. One of the two commands in- 
volved in file transfer. When you receive a file, a 
copy of the file goes from the host session to the 
personal computer session. (Contrast with Send 
command.) 


record. Within the autokey function, the work 
station function from which sequences of key- 
strokes are entered for playback at a designated 
location. 


Resolution. A measure of the ability to distin- 
guish closely adjacent optical images. 


Restore command. The work station command 
that allows you to load autokey recordings, note- 
pad information, and/or screen profiles from per- 
sonal computer diskette or fixed disk storage to 
work station temporary storage. (Contrast with 
Save command.) 
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right control keys. The keyboard area to the 
immediate right of the main keyboard area (the 
typewriter key area) containing the black cursor 
movement keys used by the host, notepad, work 
station, and personal computer functions. 


S 


Save command. The work station function that 
allows you to move autokey recordings, notepad 
information, and/or screen profiles from work 
station temporary storage to personal computer 
diskette or fixed diskette storage. (Contrast with 
Restore command.) 


screen. The display surface. 


screen background color. The color of the dis- 
play screen in the application window area not 
covered by windows. 


screen profiles. Sets of window configurations; 
there are ten of these in your work station, num- 
bered 0 through 9. The number of windows on 
Screen Profile 0 is set at customization. The re- 
maining nine screen profiles are flexible in terms 
of number and placement of windows. You move 
through them (1) sequentially by pressing shift 
+ ChgSc, or (2) individually by pressing the WS 
Ctrl key and a screen profile number (0 through 
9). 


selected window. In work station control mode, 

the double-bordered window that will be affected 
by work station functions. (Contrast with active 
window.) 


Send command. One of the two commands 
involved in file transfer. When you send a file, a 
copy of the file goes from your personal com- 
puter session to a host session. (Contrast with 
Receive command.) 


session. A connection between your work sta- 
tion and a host computer, a personal computer, 
or a notepad. 


SetUp. The work station control function from 
which aspects of screen layout may be changed 
(for example, sizing and moving windows). 


Shift. The set of key functions printed on the 
keyface at the top of the key; initiated by press- 
ing the desired key + Shift. 


short name. A letter name (A through Z) of a 
window displayed in the upper left corner of a 
window border; within the autokey function, a 
short name is a unique name of one or more char- 
acters for your recording that is shorter than the 
complete recording name. 


single-place symbol set. A Programmed Symbol 
set that has no inherent color characteristic. 
Single-plane symbol sets are, however, available 
for both monochrome and color displays. (Con- 
trast with triple-plane symbol set.) 


size. The work station function that allows you 
to change the bottom and right boundaries of a 
window, either to enlarge or to diminish its size. 


software. Programs, procedures, rules, and 
any associated documentation pertaining to the 
operation of a computer system. (Contrast with 
hardware.) 


Source. The work station function within Copy 
in which the lines are marked with Cursor Select 
as those to be copied into another window. (Con- 
trast with Target.) 
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system reset. Within the personal computer ses- 
sion, the function that produces a result similar 
to that of a power on. It is accomplished by 
pressing and holding these three keys in succes- 
sion: the Alt key, the Ctrl key, and the Del key. 


system unit. The part of your IBM 3270 Per- 
sonal Computer that interprets between the 
display and the keyboard. It accomplishes the 
control program and personal computer 
procesing and controlling operations for the 
work station. 


T 


Target. The work station function within Copy 
in which the upper left-hand corner of a location 
is marked with Cursor Select, indicating the 
place where marked source lines are to be moved. 
(Contrast with Source.) 


template. A guide that fits around a section of 
the keyboard and identifies keys valid during a 
specified application. 


toggle key. A key that turns a function on the 
first time you press it and off the next time you 
press it. Toggle keys on your work station in- 
clude the work station control key, SetUp (PF 2), 
Browse (PF3), and the pause key in work station 
control mode; and the CapLk and NumLk keys 
in the personal computer session. 


triple-plane symbol set. A Programmed Symbol 
set that allows more than one color to be used in 
a single character position. Triple-plane symbol 
sets contain three times the normal amount of 
storage for each defined character, arranged in 
three planes, representing the three primary 
colors, red, blue, and green. By defining only a 
portion of the total symbol in each color plane, 
the user can obtain a whole symbol in more than 
one color. (Contrast with single-plane symbol 
set.) 


typematic. Key functions that will repeat when 
the key is held down. 


typewriter key area. The large central area of 
the keyboard containing the familiar typewriter 
keys; also called the ‘“‘qwerty”’ keys. 


U 


Un-Enlarge. A toggle key that allows you to re- 
turn enlarged windows to their pre-enlarged size. 


Un-Hide. The work station control function that 
allows you to return a hidden window to the 
screen in the same size and position in which it 
was hidden. 


Vv 


valid key. A key that is recognized by the ses- 
sion type (host, personal computer, or notepad) 
or mode (WS Ctrl) to which your keyboard is 
logically ‘“‘attached.”’ 


WwW 


window. The ‘‘opening”’ on the screen through 
which you view your application data sets. A 
window can be the same size as your full IBM 
3270 Personal Computer screen or as small as 
one character. Your work station allows you to 
have up to 40 windows distributed over your 10 
screen profiles. 


work station control mode. The master control 
mode of the IBM 3270 Personal Computer from 
which the control program functions are ac- 
cessed and quit by the WS Ctrl key, which is a 
toggle. (Compare with application mode.) 
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3 


3274-attached printer. The centralized printer 
attached indirectly to your work station by 
means of a 3274 Control Unit; a printer that 
serves a number of uses. 


Index 


A 


active window 
cursor 2-7 
definition 2-7 
double-bordered 2-7 
adapter cards 
All-Points-Addressable 
(APA) graphics 1-8 
programmed symbols _ 1-8, 
H-3 
Add _ 7-3 
adding a window 7-8 
All Points Addressable (APA) 
graphics adapter 1-8 
Alt key 4-7 
Alt + PF13-20 
work station control 
mode 6-15 
AltCr key 6-16 
APA graphics adapter 1-8 
APAR (Authorized Problem 
Analysis Report) 
creating a patch file C-6 
definition C-4 
history list C-10 
listing current system 
level C-10 
listing currently installed 
APARs_ C-10 
permanent changes C-8 
prerequisite APAR C-4 
seven-character APAR 
number C-4 
application mode 
active window 2-7 
definition 2-18, 4-3 
description 5-3 
host computer key areas 
(see host computer key 
areas) 


host computer keys (see 
host computer keys) 
host session 2-5, 5-4 
invalid key 5-3 
keyboard functions 
host computer 5-4 
notepad session 5-26 
personal computer 
session 5-30 
work station control 
mode 6-5 
notepad key functions 
5-26 
notepad session 2-5 
operator information area 
(OIA) 2-22 
personal computer key 
areas (see personal 
computer key area) 
personal computer keys (see 
personal computer keys) 
personal computer 
session 2-5 
printing 
in host sessions 12-7 
personal computer 
session 12-6 
program function (PF) key 
definition 5-3 
valid key 5-3 
working in 5-3 
application mode operation 
IBM 3270 Personal 
Computer failure G-51 
personal computer display 
blanking G-53 
personal computer print 
spooling G-50 
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application window area 
definition 2-27 
Attachment options panel 
A-29 
Attn key 5-7 
Authorized Problem Analysis 
Report (see APAR) 
Auto key 6-9 
Autoexec.bat F-3, F-5 
autokey 
definitions 
recording name 10-3 
variable 10-3 
erasing arecording 10-22 
invalid keys 10-7 
keys to use 


Auto 10-6 
ErInp 10-7 
Finish 10-7 
Pause 10-7 
Play 10-6 
Quit 10-13 
Record 10-6 


list key (PF1) 2-31, 4-10, 
10-4 
playing arecording 2-34, 
10-17 
problem determination 
B-11 
erase B-40 
play B-28 
recording keystrokes 
getting ready 10-8 
how to 10-10 
recording name 10-10 
autokey recordings (see also 
autokey) 
restoring 11-7 
saving 11-7 
saving with notepads, 
screen 
profiles 11-8 
auto-windowing 2-16 
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B 


background color 
definition 7-4 
display screen 7-7 
window 7-29 
background key (PF24) 6-17 
Backspace key 5-12 
base color 5-25, 7-4 
base color key (PF21) 6-16, 
7-25 
batch files F-3 
blink highlighting 5-24 
border 2-14 
Break key 5-44 
browse (see browsing) 
browse key (PF3) 4-9, 6-13, 
8-4 
browsing 
definition 2-33, 8-3 
description 8-3 to 8-4 
pel by pel 8-5 
personal computer graphics 
window 8-5 
presentation space 2-33 
windows 2-33, 8-4 


C 


cancel current function 6-21 
CapsLk key 4-9, 5-37 
card slot assignments (see 
mandatory card slot 
assignment) 
changing colors 
description 7-22 
screen background 7-27 
window foreground and 
background 7-29 
ChgSc key 
application mode __ 5-7, 5-33 
definition 2-12 
work station control 
mode 6-7 


Clear key 5-6 


color 
base 5-25, 7-4 
changing 


display screen 
background 7-27 
foreground and © 
background 7-29 
keys to use for 7-23 
color key (PF8) 6-14 
color of operator information 
area (OJA) 
in application mode 2-22 
in work station control 
mode 2-23 
command procedures 
for file transfer F-8 
for save/restore F-4 
for trace 
/d parameter D-4 
trace off D-3 
traceon D-3 
communication problem 
determination B-53 
communication 
indicators B-54 to B-56 
program error codes B-57 
communication session 
termination G-46 
control program A-3 


copying onto fixed disk A-15 


to A-16 
loading 3-7 
onto fixed disk A-8, 
A-19 to A-20 
patch (see patch) 
control unit terminal (CUT) 
customizing A-29 to 
A-31 
copy 
definition 2-33, 9-3 
levels 6-18 
Copy key 6-8 
copying data 9-3 
definitions 
copy 9-3 
source 9-3 
target 9-4 


from one window to © 
another 9-19 
into protected fields 9-4 
lines 9-3 
overlaying data 9-5 
repeated copying 9-11 
to another window 9-9 
defining source 9-6 
defining target 9-9 
within a window. 9-6 to 
9-11 : 
defining source 9-6 
defining target 9-9 
words 9-3 
corner 17-4 . 
corner key (PF10). 6-14 
cornering a window 7-17 
creating a command 
procedure F-6 —: 
creating a patch file C-6 
for a fixed disk C-6 
for multidiskette drives 
C-6 a 
creating an Autoexec.bat 
file F-5 
CrSel key 5-8 
Ctrl key 5-35 
current system level 
listing C-10 
currently installed APARs 
(see APAR) 
cursor 
active window 2-7 
selecting types 5-8 
cursor movement keys 5-17 
customization 
background information 
A-3 to A-8 
3274 Control Unit 
configuration A-3 
considerations A-3 to A-8 
control unit terminal 
(CUT) A-29 to A-31 
copying control program 
onto fixed disk A-15 
to A-16 
description A-3 
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distributed function 
terminal (DFT) A-28 
to A-31 

estimating memory size 
A-40 

fixed disk 

copying control program 
onto A-15 to A-16 

formatting system 
diskette A-17 

information worksheet 
A-41 to A-43 

loading customization 
program into memory 
A-20 

memory size estimating 
A-40 

messages E-4 

one-diskette drive 


system A-6 
panels 
how touse A-21] 
types 
Attachment 
options A-29 
Customization 
in progress A-37 
Customization 


summary A-34 
Hardware options 
A-27 
Help A-23 
Home A-25 
Host session 
options A-32 
Sessions 
Definitions A-28 
preparing to customize 
A-14 
problem determination 
B-63 
recustomizing from a 
previously created 
system A-9 
specifying multiple host 
sessions A-28 
system diskette A-19 
formatting A-17 
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two-diskette drive 
system A-6 
using panels 
Worksheet 
(see information 
worksheet) 
customization in progress 
panel A-37 
customization summary 
panel A-34 
customizing system 
diskette A-19 
customizing (see 
customization) 


A-21 


CUT (see control unit terminal 


(CUT)) 


D 


defined screen profile 2-12, 
7-4 
defining screen profiles 7-6 
definitions of terms 
add 7-4 
application mode 2-18, 4-3 
background color 7-4 
base color 7-4 
browsing 2-33 
ChgSc 2-12 
copy 2-33 
corner 7-4 
customization 2-10 


defined screen profile 2-12, 


7-4 

delete 7-4 

diskette 3-3 
enlarge 2-14 
foreground color 7-4 
hide 7-5 

host session 2-5 
invalid key 5-3. 


list 2-31 
load 3-4 
move 7-5 


presentation space 2-4 
program function (PF) 
key 5-3 


recording and playing 
keystrokes 2-34 
recording name 10-3 
screen background color 
7-5 
- screen profile 0 3-9 
screen profiles 2-10 
size 7-5 
toggle 4-3 
valid key 5-3 
window 2-5 
work station control 
mode 2-20, 4-3 
delete 7-4 
delete a window (see deleting 
a window) 
Delete key 5-16, 5-47 
Delete Window key 6-10 
deleting a window 7-11 
DFT (see distributed function 
terminal) 
disk, fixed A-15 to A-16 
disk operating system 
(see DOS) 
diskette 
blank A-6 
general information 3-5 
handling 3-5 
inserting 3-6 
loading 3-7 
removing 3-14 
diskette, system 
customizing A-19 
display blanking G-53 
display monitor 1-5 
display screen 
application window area 
2-27 
message line/user prompt 
area 2-27 
operator information 
area 2-27 
display screen background 
color 7-27 
distributed function terminal 
(DFT) customizing A-28 to 
A-31 DOS A-5 
double-bordered window 
active 2-7 
selected 2-20 


dump 
trace (with 
/d parameter) D-4 
Dup key 5-15 


E 


EDLIN editor 3-13 
End key 5-46 
Enlarge key 
application mode _ 5-9, 5-35 
definition 2-14, 4-9 
work station control 
mode 6-9 
Enter key 5-37 
Erase EOF key 5-8 
erasing arecord 10-22 
ErInp key 
application mode 5-8 
work station control 
mode 6-8 
error codes (see program 
error codes) 
Esc key 5-43 
estimating storage size A-40 
ExSel key 5-7 


F 


field mark key 5-15 
file transfer 
command format 13-5 
commands 13-5 
creating command 
procedures F-6 
description 13-3 
format notation 13-5 
how todo 13-6 
messages E-40 
problem determination B-68 
Receive command 13-13, 
13-25 
receiving TSO data set 
from host 
partitioned 13-28 
physical-sequential 
13-28 
Send command 13-8, 13-18 
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sending files to host 
partitioned 13-23 
physical-sequential 
13-23 
TSO 
Receive command 13-25 
receiving data set from 
host 13-25 
Send command 13-18 
sending files to host 
13-18 
VM/CMS 
Receive command 13-13 
receiving files from 
host 13-13 
Send command 13-8 
sending files to 
host 13-8 
Finish key 6-7 
fixed disk A-14, A-33 
foreground color 
changing 7-29 
definition 7-4 
foreground key (PF23) 6-16 
format of patch (see patch) 
formatting system 
diskette A-17 
function levels 6-18 


G 


graphics 8-5 
browsing 
pel by pel 8-5 
personal computer 
graphics window 8-5 
using APA graphics 
adapter 1-8 
using programmed 
symbols 1-8, H-3 


H 
handling diskettes 3-6 
hardware 1-5 


hardware options panel A-27 
head slot 3-5 
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Help 
online aid 1-9 
tutorial 1-9 
Help key 4-10, 6-7 
Help panels 2-28, 4-9 
HELPER tutorial online 
aid 1-9, 2-32 
hide 7-5 
hide key (PF9) 6-14 
hiding a window 7-19 
highlighting 
blink 5-24 
reverse video 5-23 
underscore 5-24 
high resolution G-52 
history list (see APAR history 
list) 
Home key 5-18, 5-44, 7-15, 
10-4 
Home panel A-25 
host computer key areas 
left control key area 5-5 to 
5-10 
numeric key area 5-19 
program function key 
area 5-21 
right control key area 5-14 
typewriter key area 5-11 
host computer keys 
Attn 5-7 
Backspace 5-12 
ChgSc 5-7 
Clear 5-6 
CrSel 5-8 
cursor movement 5-17 
Delete 5-16 
Dup 5-15 
Enlarge 5-9 
Enter 5-20 
Erase EOF 5-8 
ErInp 5-8 
ExSel 5-7 
Field Mark 5-15 
Home 5-18 
Ident 5-9 
Ins(Insert) 5-16 
Jump 5-7 
New Line 5-12 
PA1-PA3 5-15 


PF1-PF24 5-22 to 5-25 
PSA-PSF 5-22 
Print 5-8 
Reset 5-10 
Space 5-13 
SysRq 5-6 
Tab 5-12 
Tab left 5-15 
Tab right 5-20 
Test 5-6 
WS Ctrl 5-7 
host session 
definition 2-5 
graphics in 1-8, H-3 
number of 2-5 
printing 12-7 
programmed symbols H-3 
specifying multiple A-28 
to A-31 
host session options 
panel A-32 


I 


IBM 3270 Personal Computer 
failure G-51 
graphics color printer 
2-35, 12-8 
problem determination 
B-5 
IBM 3274 communication 
session termination G-51 
IBM 3274 Control Unit 
1-8, A-3 
IBM 3278 Display Station 
1-8 
IBM 3279 Display Station 
5-4 
Ident key 5-9 
INDCFIG command A-5 
INDPATCH command C-8 
INDRSTR command (see 
Save/Restore) 
INDSAVE command (see 
Save/Restore) 
Information worksheet A-41 
Ins (Insert) key 4-10, 5-16, 
5-34 


inserting diskettes 3-7 
installed APARs (see APAR) 
installing a patch C-8 
introduction 1-3 

invalid key 5-3 


J 


Jump key 2-8 to 2-9 
application mode _ 5-7, 5-25 
work station control 

mode 6-8 
jumping from window to 
window 2-8 


K 


keyboard 

application mode 
host keyboard 5-4 
notepad keyboard 5-26 
personal computer 

keyboard 5-30 

areas 
left control keys 4-5 
numeric keypad 4-5 
program function (PF) 

keys 4-5 

right control keys 4-5 
typewriter keys 4-5 

color of engravings 4-8 

description 1-5, 4-7 

diagram 4-6 

problem determination B-80 

purpose 4-4 

special keys 4-8 

toggle keys 4-9 

using 4-4 

work station control 

mode 4-4 
keystrokes (see autokey) 


L 


left control keys 4-5 
level 1 functions 6-18 
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level 2 functions 
autokey 6-18 
browse 6-18 
copy 6-18 
SetUp 6-18 
level 3 functions 
copy 
source 6-19 
target 6-19 
SetUp 
color 6-19 
corner 6-19 
hide 6-19 
move 6-19 
size 6-19 
levels of functions 6-18 
list 
definition 2-31 
in autokey 10-4 
in work station control 
mode 2-31, 10-4 
removing from screen 10-4 
list key (PF1) 2-31, 4-10, 6-13 
load 3-4 
loading control program 3-7 
loading diskettes 3-7 
local copy (see host session 
printing) 


M 


mandatory card slot 
assignment G-49 
medium resolution G-52 
message line/user prompt 
area 2-27 
messages 
customizing E-4 
file transfer E-40 
patch E-13 
save and restore E-21 
startup system E-30 
systemerror E-33 
trace E-38 
work station control E-51 
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modes 

application 2-18 

work station control 2-20 
monitor (see display monitor) 
move 7-5 
move key (PF11) 6-14 
moving a window 7-15 
moving between levels 6-21 


N 


New Line key 5-12 
NMI button B-5 
non-maskable-interrupt 
(NMI) button B-5 
notepad key functions 5-26 
notepad session 
creating command 
procedures F-6 
definition 2-5 
number of 2-5 
printing 12-4 
using 5-26 
notepads 
creating programmed 
command procedures F-6 
restoring 11-6 
saving 11-6 
saving with autokey 
recordings and screen 
profiles 11-8 
numeric keypad 4-6 
NumLk key 4-10, 5-43 


O 


OIA (see operator information 
area) 
one-diskette drive system 
customizing A-6 
online aids 
Help 1-9 
HELPER tutorial 1-9 
operator information area 
(OIA) 


communication 
indicators B-54 to B-56 
definition 2-22 
in application mode 2-22 
in work station control 
mode 2-25 
online aid 1-9 


P 


page down (PgDn) key 5-47 
page up (PgUp) key 5-45 
panels, customization (see 
Customization, panels) 
partitioned data set 
example for file 
transfer 13-12 
patch 
defining format of 
pre-APAR C-4 
pre-level C-4 
ZAP C-4 
file 
creating for a 
fixed disk C-6 
multidiskette 
drive C-6 
single-diskette 
drive C-6 
installing C-8 
DOS E-3 
messages (PATnn) E-13 
problem determination B-91 
removing C-11 
pause, using 10-13 
Pause key 4-10, 6-9, 10-7 
PA1-PA3 keys 5-15 
personal computer application/ 
control program problem 
determination B-94 
personal computer application 
mode operation G-50 
personal computer display 
blanking G-53 
personal computer key areas 
left control key area 5-31 
numeric keypad area 5-42 


program function (PF) key 
area 5-48 
right control key area 5-39 
typewriter key area 5-36 
personal computer keys 
arithmetic symbols 5-43 
Break 5-94 
CapsLk 5-37 
ChgSc 5-33 
Ctrl 5-35 
Del (Delete) 5-47 
End 5-46 
Enlarge 5-35 
Enter 5-37 
Esc 5-43 
Home _ 5-44 
Ins (Insert) 5-47 
Jump 5-34 
NumLk 5-43 
PgDn_ 5-47 
PgUp_ 5-45 
Print 5-34 
program function (PF) 5-49 
Quit 5-35 
SerLk 5-43 
Shift 5-38 
Space 5-44 
SysRq 5-32 
Tab right 5-35 
WS Ctrl 5-32 
personal computer print 
spooling G-50 
personal computer session 
autokey recording in 10-17 
definition 2-5, 5-30 
graphics in 8-5 
browsing windowsin 8-5 
printing 12-5 
number of 2-5 
printing 12-6 
PF key (see program function 
(PF) keys) 
PgDn key 5-47 
PgUp key 5-45 
picel (see picture element) 
picture element (pel) 8-5 


Index X-27 


play key (PF4) 6-14 
playing arecord 10-17 
prerequisite APAR C-4 
presentation space 
browsing 2-33 
definition 2-4 
primary colors (see 
programmed symbols) 
print (see printing) 
Print key 
application mode 5-8, 5-34 
work station control 
mode 6-8 
printing 
canceling 12-4, 12-5 
colors 12-8 
description 12-3 
display screen 
cancelling 12-4 
IBM 3270 Personal 
Computer - supported 
locally attached 
printer 12-4 
graphics 8-5 
graphics color 
printing 12-8 
highlighting 12-8 
host session 12-7 
IBM 38270 Personal 
Computer - supported 
locally attached 
printer 2-35, 12-4 
IBM 3274-attached 
printer 2-35, 12-7 
notepad session 12-4 
personal computer 
session 12-5 
printers 
IBM 38270 Personal 
Computer supported 
locally attached 


printer 12-4 
IBM 3274-attached 
printer 12-7 


problem determination B-86 
programmed symbols 12-8 
windows 12-5 
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work station control 
mode 12-4 
problem determination 
autokey B-11 to B-52 
erase B-40 
play B-28 
communication B-53 
program error 
codes B-57 
customization B-63 
file transfer B-68 
IBM 3270 Personal 
Computer printer B-86 
keyboard B-80 
patch B-91 
personal computer 
application/control 
program B-94 
program error 
codes B-57 
save and restore B-96 
system error B-98 
system startup B-113 
trace B-118 
work station control 
mode B-119 
profiles (see screen profiles) 
program error codes B-57 
program function (PF) keys 
definition 5-3 ‘ 
description 4-5 


keys 
PF1 5-22, 6-138 
PF2 5-22, 6-13 
PF3 5-22, 6-13 
PF4 5-22, 6-13 
PF5 5-22 
PF6 5-22 
PF7 5-23 
PF8 6-14 
PF9 5-23, 6-14 
PF10 5-24, 6-14 
PF11 5-24, 6-14 
PF12 5-24, 6-15 
PF13 5-24, 6-15 
PF14 5-24, 6-15 
PF15 5-24, 6-15 


PF16 5-24, 6-15 
PF17 5-24, 6-15 
PF18 5-24, 6-15 
PF19 5-24, 6-15 
PF20 6-15 
PF21 5-25, 6-16 
PF22 6-16 
PF23 5-25, 6-16 
PF24 6-17 


programmed control 
procedures F-6 
programmed symbols 
(PS) 5-22, 9-5, H-3 
printing with 12-8 
primary colors H-9 
secondary colors H-11 
single-plane H-8 
triple-plane H-8 
PS keys (see programmed 
symbols (PS)) 


Q 
Quit 5-25 
R 


Receive (TSO) command (see 


TSO Receive command) 


Receive (VM/CMS) command 


(see VM/CMS Receive 
command) 
receiving files from host 
TSO 13-25 
VM/CMS 13-18 
record key (PF16) 6-15 
recording keystrokes (see 
autokey) 
recording name _ 10-3 
recustomizing from a 
previously created 
system A-9 
removing apatch C-11 
removing diskettes 3-14 
Reset key 5-10 
resolution 
high G-54 
medium G-54 


Restore (see Save/Restore) 
restoring (see Save/Restore) 
reverse video 5-23 

right control keys 4-5 


S 


Save (see Save/Restore) 
save and restore (see 
Save/Restore) 

save command 

BAT file extension F-5 
batch files F-3 
command procedure F-6 

Save/Restore 

command notation 11-15 
default files 
changing 11-9 
replacing 11-9 
definitions 
Restore 2-34, 11-4 
Save 2-34, 11-4 
description 11-3 
formatting the 
commands 11-16 


INDRSTR command 11-5 
INDSAVE command 11-5 
messages from E-21 
problem determination B-96 
restoring 

all user-named files 11-9 

autokey 

recordings 11-13 

notepads 11-11 

one notepad 11-12 

screen profile 0 3-13 

screen profiles 11-10 
saving 

all user-named files 11-9 

autokey 

recordings 11-13 

notepads 11-11 

one notepad 11-12 

screen profile 0 3-12 

screen profiles 11-10 
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user-named files 11-9 
saving (see Save/Restore) 
saving files (see Save/Restore) 
screen background color 

changing color 7-27 

definition 7-4 
screen background key 

(PF22) 6-16 

screen profiles 

adding a window 7-8 

definition 2-10 

listing 2-31 

number of 2-10 

restoring 3-13, 11-10 

restoring with autokey 

recordings and 
notepads 11-14 
saving 3-12, 11-10 
saving with autokey 
recordings and 
notepads 11-14 

screen profile 0 2-10, 3-9 

selecting 6-21 
ScrLk key 5-43 
secondary colors (see 

programmed symbols (PS) 

selecting a screen profile 6-21 

selecting a window 2-7, 6-23 

Send (TSO) command (see 
TSO Send command) 

Send (VM/CMS) Command 
(see VM/CMS Send 
command) 

sending files to host 

TSO 18-18 

VM/CMS._ 13-8 
session 

kinds of 2-5 

number of 2-5 
sessions definitions 

panel A-28 

SetUp (see work station 
control mode) 

SetUp key (PF 2) 

Shift key 5-38 

single diskette drive system 
(see one-diskette drive 
system) 


4-11, 6-13 


X-30 


single-plane (see programmed 
symbols (PS)) 
size 7-5 
size key (PF12) 6-15 
sizing a window 7-13 
SNA _ A-29 
source 
defining 
copying to another 
window 9-11 
copying within a 
window 9-6 to 9-11 
definition 9-3 
description 9-3 
source key (PF13) 6-15 
Space 5-44 
Space bar 5-13 
structured fields G-33 
summary card 1-10 
SysRq key 5-6, 5-32 
system diskette 
customization A-19 
formatting A-17 
system error 
messages E-33 
problem determination B-98 
system level (see also APAR) 
current listing C-10 
system messages E-33 
system network architecture 
(see SNA) 
system startup 
messages E-30 
problem 
determination B-113 
system unit 1-5 


T 


Tab key 5-12 
Tab left key 5-15 
Tab right key 5-20, 5-43 
target 
defining 
copying to another 
window 9-9 
copying within a 
window 9-6 to 9-11 


definition 9-3 
description 9-3 
target key (PF14) 6-5 
technical notes 
IBM 3270 data system 
functions G-7 
IBM 3270 limitation G-6 
IBM 3270 Personal 
Computer failure 
personal computer 
display blanking G-53 
personal computer 
print spooling G-50 
card slot assignments G-49 
technicolor typing 5-28 
Test key 5-6 
time sharing option (see TSO) 
toggle 4-3 
toggle keys 
definition 4-3 
description 4-9 
keys 
Browse 4-9 
CapLk 4-9 
Enlarge 4-9 
Help 4-10 
Ins (Insert) 
List 4-10 
NumLk 4-10 
Pause 4-10 
SetUp 4-11 
WS Ctrl 4-11 
trace 
commands D-3 
definition D-3 
events D-3 


G-51 


4-10 


messages (TRnnn) E-38 
problem 

determination B-118 
syntax D-3 


trace off D-3 

trace on D-3 

transferring files (see file 
transfer) 

triple plane (see programmed 
symbols (PS)) 

TSO (time sharing option) 

file transfer 


receiving data sets from 
host 13-25 
sending files to 
host 13-18 
Receive command 13-25 
example 13-28 
format 13-25 
partitioned data 


set 13-28 
physical-sequential data 
set 13-28 


Send command 13-18 
example 13-23 
format 13-18 
partitioned data set 13-23 
physical-sequential data 
set 13-23 
tutorial 
HELPER online aid 1-9 
typewriter keys 4-6 


U 


underscore highlighting 5-24 
unhiding a 
window 7-19 to 7-20 
user-named files 
Saving and restoring 


all files 11-14 
autokey 

recordings 11-13 
command 


notation 11-15 
formats touse 11-16 
notepads 11-11 
one notepad 11-12 
screen profiles 11-10 


Vv 


valid key 5-3 
variable 10-3 
VM/CMS 13-8 
file transfer 
receiving files from 
host 13-13 
sending filestohost 13-8 
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Receive command 13-13 
example 13-16 
format 13-13 

Send command 13-8 
example 13-12 
format 13-8 
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window 

active 2-7 
arrangements on 
screen 2-5 
adding a 7-8 
auto-windowing 2-16 
border 2-14 
browsing 2-38, 8-5 
colors 7-25, 7-27 
cornering 7-17 
definition 2-5 
deleting 7-11 
enlarging 2-14 
foreground and 
background 7-9 
graphics 

personal computer 

browsing 8-5 
hiding 7-19 
moving 7-15 
number of sessions 2-5 
printing 12-4 


selecting 2-20 to 2-21, 6-23 


short name 2-6 
size of 2-5 
sizing 7-13 
unhiding 7-19 to 7-20 
worksheet (see Information 
worksheet) 


work station description 1-3 


work station control mode 
adding windows 7-8 
autokey (see autokey) 
browsing 

windows 2-33, 8-4 

changing color in 7-22 
copy 2-33 
definition 4-3 
deleting windows 7-11 
enlarging windows 2-14 
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functions 
autokey 6-18 
browse 6-18 
copy 6-18 
Help 6-7 
list 6-4 
print 6-8 
Setup 6-18 
introduction to 2-20 
key areas 
left control key area 6-6 
numeric key area 6-11 
program function 
key area 6-12 
typewriter key area 6-11 
keys 
AltCr 6-16 
Alt + PF13-20 6-15 
Alt + PF23 6-16 
Auto 6-9 
background key 
(PF22) 6-16 
base color (PF21) 
key 6-16 
browse (PF3) 6-13 
ChgSc key 6-7 
color (PF8) key 6-14 
Copy key 6-8 
corner key (PF10) 6-14 
cursor keys 5-17 
Delete Window key 6-10 
Enlarge key 6-9 
ErInp key 6-8 
Finish key 6-7 
foreground key 
(PF23) 6-16 
Help key 6-7 
hide key (PF9) 6-14 
Jump key 6-8 
list key (PF1) 6-13 
move key (PF11) 6-14 
Pause key 6-9 
play key (PF4) 6-14 
Print key 6-8 
Quit key 6-10 
record key (PF16) 6-15 
screen background key 
(PF22) 6-16 
SetUp key (PF2) 6-13 


size key (PF12) 6-15 
source key (PF13) 6-15 
target key (PF14) 6-15 
WS Ctrl key 6-7 
levels of functions 6-18 
messages E-51 
operator information area 
(OIA) 2-25 
overview 6-4 
printing windows 12-5 
printing the screen 12-4 
program function keys 
(see program 
function (PF) keys) 
recording keystrokes 2-34 
selecting a screen 
profile 6-21 
selected 
windows 2-20 to 2-21 
selecting a window 6-23 
SetUp 
color 7-22 
corner 7-17 
getting into 7-7 
getting out of 7-7 
hide 7-19 
levels of 6-18 
move 7-15 
size 7-13 
using 7-7 
work station control problem 
determination B-109 
WS Ctrl 
key 4-11, 5-7, 5-32, 6-7 


3 


3270 limitations G-6 

3274 Control Unit 
configuration A-3 

3274-attached printer 12-7 

3278 Display Station 1-8 

3279 Display Station 5-4 
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